AdsApp
Este é o objeto de nível superior utilizado para aceder e gerir uma única conta.
Nota
Este objeto substitui o objeto BingAdsApp . No futuro imediato, os Scripts continuarão a suportar o BingAdsApp para retrocompatibilidade; No entanto, recomendamos que atualize os scripts para utilizar este objeto o mais rapidamente possível.
Métodos
| Nome do Método | Tipo de Devolução | Descrição |
|---|---|---|
| adGroups | AdGroupSelector | Obtém um seletor utilizado para filtrar a lista de grupos de anúncios nesta conta. |
| anúncios | AdSelector | Obtém um seletor utilizado para filtrar a lista de anúncios nesta conta. |
| orçamentos | BudgetSelector | Obtém um seletor utilizado para filtrar a lista de orçamentos partilhados nesta conta. |
| campanhas | CampaignSelector | Obtém um seletor utilizado para filtrar a lista de campanhas nesta conta. |
| createLabel(nome da cadeia, descrição da cadeia, backgroundColor de cadeia) | vazio | Cria uma etiqueta. |
| currentAccount | Conta | Obtém a conta que o script está atualmente a processar. |
| getExecutionInfo | ExecutionInfo | Devolve informações sobre o ambiente no qual o script está atualmente a ser executado. |
| palavras-chave | KeywordSelector | Obtém um seletor utilizado para filtrar a lista de palavras-chave nesta conta. |
| etiquetas | Seletor de Etiquetas | Obtém um seletor utilizado para filtrar a lista de etiquetas nesta conta. |
| negativeKeywordLists | NegativeKeywordListSelector | Obtém um seletor utilizado para filtrar a lista de listas de palavras-chave negativas nesta conta. |
| newNegativeKeywordListBuilder | NegativeKeywordListBuilder | Obtém um construtor utilizado para adicionar uma lista de palavras-chave negativas a esta conta. |
| productGroups | ProductGroupSelector | Obtém um seletor utilizado para filtrar a lista de grupos de produtos nesta conta. |
| shoppingAdGroups | AdGroupSelector | Obtém um seletor utilizado para filtrar a lista de grupos de anúncios utilizados para fazer compras nesta conta. |
| shoppingCampaigns | CampaignSelector | Obtém um seletor utilizado para filtrar a lista de campanhas utilizadas para fazer compras nesta conta. |
| userLists | UserListSelector | Obtém um seletor utilizado para filtrar a lista de listas de utilizadores nesta conta. |
adGroups
Obtém um seletor utilizado para filtrar a lista de grupos de anúncios nesta conta.
Devoluções
| Tipo | Descrição |
|---|---|
| AdGroupSelector | Um seletor utilizado para filtrar a lista de grupos de anúncios na conta atual. |
anúncios
Obtém um seletor utilizado para filtrar a lista de anúncios nesta conta.
Devoluções
| Tipo | Descrição |
|---|---|
| AdSelector | Um seletor utilizado para filtrar a lista de anúncios na conta atual. |
orçamentos
Obtém um seletor utilizado para filtrar a lista de orçamentos partilhados nesta conta.
Este método devolve apenas orçamentos partilhados. Para obter orçamentos não partilhados (campanha individual), chame o método getBudget da campanha específica. O orçamento da campanha não é partilhado se o isExplicitlyShared método devolver falso.
Devoluções
| Tipo | Descrição |
|---|---|
| BudgetSelector | Um seletor utilizado para filtrar a lista de orçamentos partilhados na conta atual. |
campanhas
Obtém um seletor utilizado para filtrar a lista de campanhas nesta conta.
Devoluções
| Tipo | Descrição |
|---|---|
| CampaignSelector | Um seletor utilizado para filtrar a lista de campanhas na conta atual. |
createLabel(nome da cadeia, descrição da cadeia, backgroundColor de cadeia)
Cria uma etiqueta.
Para obter limites sobre o número de etiquetas que pode criar por conta, veja Limites. Para obter um exemplo que adiciona uma etiqueta a uma conta, veja Utilizar etiquetas.
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| backgroundColor | cadeia | Opcional. A cor de fundo a utilizar na experiência de utilizador para a etiqueta. Pode especificar a cor com:
|
| descrição | cadeia | Opcional. Uma descrição que descreve a utilização da etiqueta. O tamanho máximo é de 200 carateres. Se especificar backgroundColor, tem de fornecer uma descrição ou uma cadeia vazia (""). |
| nome | cadeia | Obrigatório. O nome da etiqueta. O nome é sensível às maiúsculas e minúsculas e tem de ser exclusivo na conta. O tamanho máximo é de 80 carateres. O método corta o espaço em branco à esquerda e à direita do nome. |
Devoluções
| Tipo | Descrição |
|---|---|
| vazio | Não devolve nada. |
currentAccount
Obtém a conta que o script está atualmente a processar.
Nota
Para utilizar este método num cenário de várias contas, selecione primeiro uma conta para gerir. Se chamar este método antes de selecionar uma conta, a chamada devolve nulo.
Devoluções
| Tipo | Descrição |
|---|---|
| Conta | A conta que o script está atualmente a processar. Para ver como utilizar isto num cenário de várias contas, veja o método select de AccountsApp. |
getExecutionInfo
Devolve informações sobre o ambiente no qual o script está atualmente a ser executado.
Devolve:
| Tipo | Descrição |
|---|---|
| ExecutionInfo | Informações sobre o ambiente no qual o script está atualmente a ser executado. |
palavras-chave
Obtém um seletor utilizado para filtrar a lista de palavras-chave nesta conta.
Devoluções
| Tipo | Descrição |
|---|---|
| KeywordSelector | Um seletor utilizado para filtrar a lista de palavras-chave na conta atual. |
etiquetas
Obtém um seletor utilizado para filtrar a lista de etiquetas nesta conta.
Devoluções
| Tipo | Descrição |
|---|---|
| Seletor de Etiquetas | Um seletor utilizado para filtrar a lista de etiquetas na conta atual. |
negativeKeywordLists
Obtém um seletor utilizado para filtrar a lista de listas de palavras-chave negativas nesta conta.
Devoluções
| Tipo | Descrição |
|---|---|
| NegativeKeywordListSelector | Um seletor utilizado para filtrar a lista de listas de palavras-chave negativas na conta atual. |
newNegativeKeywordListBuilder
Obtém um construtor utilizado para adicionar uma lista de palavras-chave negativas a esta conta.
Devoluções
| Tipo | Descrição |
|---|---|
| NegativeKeywordListBuilder | Um construtor utilizado para adicionar uma lista de palavras-chave negativas à conta atual. |
productGroups
Obtém um seletor utilizado para filtrar a lista de grupos de produtos nesta conta.
Devoluções
| Tipo | Descrição |
|---|---|
| ProductGroupSelector | Um seletor utilizado para filtrar a lista de grupos de produtos na conta atual. |
shoppingAdGroups
Obtém um seletor utilizado para filtrar a lista de grupos de anúncios utilizados para fazer compras nesta conta.
Devoluções
| Tipo | Descrição |
|---|---|
| AdGroupSelector | Um seletor utilizado para filtrar a lista de grupos de anúncios utilizados para compras na conta atual. |
shoppingCampaigns
Obtém um seletor utilizado para filtrar a lista de campanhas utilizadas para fazer compras nesta conta.
Devoluções
| Tipo | Descrição |
|---|---|
| CampaignSelector | Um seletor utilizado para filtrar a lista de campanhas utilizadas para fazer compras na conta atual. |
userLists
Obtém um seletor utilizado para filtrar a lista de listas de utilizadores nesta conta.
Devoluções
| Tipo | Descrição |
|---|---|
| UserListSelector | Um seletor utilizado para filtrar a lista de listas de utilizadores na conta atual. |