Partilhar via

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.
performanceMaxCampaigns CampaignSelector Obtém um seletor utilizado para filtrar a lista de campanhas máximas de desempenho nesta 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:
  • Um número hexadecimal de três bytes no formulário, #RRGGBB. Por exemplo, #CB0400.
  • Um dos 16 nomes de cores CSS conhecidos. Por exemplo, água, amarelo e fúcsia.
Considere a acessibilidade ao escolher a cor. Se não for especificado, é escolhida uma cor aleatória para si.
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 Necessá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.

performanceMaxCampaigns

Obtém um seletor utilizado para filtrar a lista de campanhas utilizadas para o desempenho máximo nesta conta.

Devoluções

Tipo Descrição
CampaignSelector Um seletor utilizado para filtrar a lista de campanhas utilizadas para o desempenho máximo na 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.

Consulte também

Acesso a uma única conta

  • Last updated on