Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Contém os métodos para gerir uma palavra-chave. Para obter informações sobre palavras-chave, consulte Palavra-chave.
Metodologia
| Nome do método | Tipo de Devolução | Descrição |
|---|---|---|
| Adicionar parâmetros | AdParamSelector | Obtém um seletor usado para obter todos os parâmetros de substituição usados no anúncio para esta palavra-chave. |
| applyLabel(nome da cadeia) | Void | Aplica a etiqueta a esta palavra-chave. |
| licitação | Palavra-chaveLicitação | Obtém os métodos usados para gerenciar o valor do lance dessa palavra-chave. |
| clearDestinationUrl | Void | Remove o URL de destino desta palavra-chave. |
| ativar | Void | Ativa esta palavra-chave. |
| getAdGroup | AdGroup | Obtém o grupo de anúncios ao qual essa palavra-chave pertence. |
| getApprovalStatus | cadeia | Obtém o estado de aprovação editorial desta palavra-chave. |
| getCampaign | Campanha | Obtém a campanha à qual essa palavra-chave pertence. |
| getEntityType | cadeia | Obtém o tipo desta entidade. |
| getFirstPageCpc | duplo | Obtém o lance estimado necessário para estar na primeira página dos resultados da pesquisa. |
| getId | cadeia | Obtém o ID que identifica exclusivamente essa palavra-chave. |
| getMatchType | cadeia | Obtém o tipo de correspondência desta palavra-chave. |
| getQualityScore | Número inteiro | Obtém o índice de qualidade desta palavra-chave. |
| getStats | Estatísticas | Obtém os dados de desempenho desta palavra-chave. |
| getText | cadeia | Obtém o texto da palavra-chave. |
| getTopOfPageCpc | duplo | Obtém o lance estimado necessário para estar na parte superior dos resultados da pesquisa. |
| isEnabled | Booleano | Obtém um valor booleano que indica se essa palavra-chave está habilitada. |
| isPaused | Booleano | Obtém um valor Booleano que indica se essa palavra-chave está pausada. |
| etiquetas | LabelSelector | Obtém um seletor usado para filtrar a lista de rótulos associados a essa palavra-chave. |
| colocar em pausa | Void | Coloca esta palavra-chave em pausa. |
| remover | Void | Remove esta palavra-chave. |
| removeLabel(nome da cadeia) | Void | Remove a etiqueta desta palavra-chave. |
| setAdParam(int index, string insertionText) | Void | Adiciona o parâmetro de substituição e define seu valor para o texto especificado. |
| URLs | Urls de palavras-chave | Obtém os métodos usados para gerenciar os URLs finais dessas palavras-chave, o modelo de acompanhamento e os parâmetros personalizados. |
Adicionar parâmetros
Obtém um seletor de todos os parâmetros de substituição usados em anúncios para esta palavra-chave.
Os valores de substituição são utilizados num anúncio se o título, o texto, o URL de visualização ou o URL de destino do anúncio contiverem a cadeia de substituição dinâmica {Param1}, {Param2} ou {Param3}.
Devoluções
| Tipo | Descrição |
|---|---|
| AdParamSelector | O seletor que contém a lista de parâmetros de substituição para esta palavra-chave. |
applyLabel(nome da cadeia)
Aplica a etiqueta à palavra-chave.
Pode aplicar um máximo de 50 etiquetas a uma palavra-chave. Para obter um exemplo que adiciona um rótulo a uma palavra-chave, consulte Usando rótulos.
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| Designação | cadeia | O nome sensível às maiúsculas e minúsculas da etiqueta. Para obter uma lista de rótulos nessa conta que você pode aplicar, consulte AdsApp.labels. |
Devoluções
| Tipo | Descrição |
|---|---|
| Void | Não devolve nada. |
licitação
Obtém os métodos usados para gerenciar o valor do lance dessa palavra-chave.
Devoluções
| Tipo | Descrição |
|---|---|
| Palavra-chaveLicitação | Contém os métodos utilizados para gerir o valor do lance desta palavra-chave. |
clearDestinationUrl
Remove o URL de destino desta palavra-chave.
Devoluções
| Tipo | Descrição |
|---|---|
| Void | Não devolve nada. |
ativar
Ativa esta palavra-chave.
Devoluções
| Tipo | Descrição |
|---|---|
| Void | Não devolve nada. |
getAdGroup
Obtém o grupo de anúncios ao qual essa palavra-chave pertence.
Devoluções
| Tipo | Descrição |
|---|---|
| AdGroup | O grupo de anúncios ao qual essa palavra-chave pertence. |
getApprovalStatus
Obtém o estado de aprovação editorial desta palavra-chave.
Devoluções
| Tipo | Descrição |
|---|---|
| cadeia | Estado de aprovação editorial da palavra-chave. O estado indica se a palavra-chave está a ser revista, se foi aprovada ou se não é permitida. Os valores possíveis são:
|
getCampaign
Obtém a campanha à qual essa palavra-chave pertence.
Devoluções
| Tipo | Descrição |
|---|---|
| Campanha | A campanha a que esta palavra-chave pertence. |
getEntityType
Devolve o tipo desta entidade.
Devoluções
| Tipo | Descrição |
|---|---|
| cadeia | O tipo desta entidade, que é Palavra-chave. |
getId
Obtém o ID que identifica exclusivamente essa palavra-chave.
Devoluções
| Tipo | Descrição |
|---|---|
| cadeia | O ID que identifica exclusivamente esta palavra-chave. |
getFirstPageCpc
Obtém o lance estimado necessário para que o anúncio apareça na barra lateral.
Devoluções
| Tipo | Descrição |
|---|---|
| duplo | O lance estimado necessário para que o anúncio apareça na barra lateral. |
getMatchType
Obtém o tipo de correspondência desta palavra-chave.
Devoluções
| Tipo | Descrição |
|---|---|
| cadeia | O tipo de correspondência da palavra-chave. Os valores possíveis são:
|
getQualityScore
Obtém o índice de qualidade desta palavra-chave.
Devoluções
| Tipo | Descrição |
|---|---|
| Número inteiro | O índice de qualidade da palavra-chave. A pontuação está entre 1 e 10 (a mais alta). Se o índice de qualidade da palavra-chave não puder ser calculado, esse método retornará NULL. A pontuação mostra o quão competitivos seus anúncios são no mercado, medindo o quão relevantes suas palavras-chave e páginas de destino são para os termos de pesquisa dos clientes. Para obter mais informações, consulte Relatório de desempenho de palavras-chave. |
getStats
Obtém dados de desempenho de palavras-chave.
Para chamar este método, tem de incluir um dos forDateRange métodos na cadeia do seletor de palavras-chave .
Devoluções
| Tipo | Descrição |
|---|---|
| Estatísticas | Os dados de desempenho da palavra-chave. Por exemplo, cliques e impressões. |
getText
Obtém o texto da palavra-chave. O texto inclui a sintaxe do tipo de correspondência da palavra-chave, se existir. Por exemplo:
- A palavra-chave é livros , se o tipo de correspondência for amplo, ou +livros , se a palavra-chave usar o modificador de tipo amplo
- A palavra-chave é "livros" se o tipo de correspondência for frase
- A palavra-chave é [livros de capa dura] se o tipo de correspondência for exato
Para obter informações sobre esses tipos, consulte O que são tipos de correspondência de palavras-chave e como usá-los?
Devoluções
| Tipo | Descrição |
|---|---|
| cadeia | É o texto da palavra-chave. |
getTopOfPageCpc
Obtém o lance estimado necessário para que o anúncio apareça acima dos resultados da pesquisa orgânica.
Devoluções
| Tipo | Descrição |
|---|---|
| duplo | O lance estimado necessário para que o anúncio apareça acima dos resultados de pesquisa orgânica. |
isEnabled
Obtém um valor booleano que indica se essa palavra-chave está habilitada.
Devoluções
| Tipo | Descrição |
|---|---|
| Booleano | É verdadeiro se esta palavra-chave estiver ativada; Caso contrário, false. |
isPaused
Obtém um valor Booleano que indica se essa palavra-chave está pausada.
Devoluções
| Tipo | Descrição |
|---|---|
| Booleano | É verdadeiro se esta palavra-chave estiver em pausa; Caso contrário, false. |
etiquetas
Obtém um seletor usado para filtrar a lista de rótulos associados a essa palavra-chave.
Devoluções
| Tipo | Descrição |
|---|---|
| LabelSelector | Um seletor utilizado para filtrar a lista de etiquetas associadas a esta palavra-chave. |
colocar em pausa
Coloca esta palavra-chave em pausa.
Devoluções
| Tipo | Descrição |
|---|---|
| Void | Não devolve nada. |
remover
Remove esta palavra-chave.
Devoluções
| Tipo | Descrição |
|---|---|
| Void | Não devolve nada. |
removeLabel(nome da cadeia)
Remove a etiqueta da palavra-chave.
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| Designação | cadeia | O nome sensível às maiúsculas e minúsculas da etiqueta. Para obter uma lista de etiquetas associadas a esta palavra-chave, consulte etiquetas. |
Devoluções
| Tipo | Descrição |
|---|---|
| Void | Não devolve nada. |
setAdParam(int index, string insertionText)
Adiciona o parâmetro de substituição e define seu valor para o texto especificado. Se o parâmetro de substituição existir, o texto é substituído.
Os valores de substituição são utilizados num anúncio se o título, o texto, o URL de visualização ou o URL final do anúncio contiverem as cadeias de substituição dinâmica {Param1}, {Param2} ou {Param3}. Para restrições e informações sobre como usar esses parâmetros, consulte Param1, Param2 e Param3.
Os valores de substituição também são usados no modelo de acompanhamento se o modelo especificar os espaços reservados {param1:default}, {param2:default} ou {param3:default}.
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| índice remissivo | int | O índice do parâmetro de substituição a definir. Os valores de índice válidos são de 1 a 3, inclusive. Use 1 para Param1, 2 para Param2 e 3 para Param3. |
| insertionText | cadeia | O texto para definir o parâmetro de substituição. |
Devoluções
| Tipo | Descrição |
|---|---|
| Void | Não devolve nada. |
URLs
Obtém os métodos usados para gerenciar os URLs finais dessas palavras-chave, o modelo de acompanhamento e os parâmetros personalizados.
Devoluções
| Tipo | Descrição |
|---|---|
| Urls de palavras-chave | Contém os métodos utilizados, os URLs finais da palavra-chave, o modelo de controlo e os parâmetros personalizados. |