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, o Scripts continuará a suportar o BingAdsApp para compatibilidade com versões anteriores; No entanto, recomendamos que atualize os seus scripts para utilizar este objeto o mais rapidamente possível.

Metodologia

Nome do método	Tipo de Devolução	Descrição
Grupos de Anúncios	AdGroupSelector	Obtém um seletor usado para filtrar a lista de grupos de anúncios nessa conta.
anúncios	AdSelector	Obtém um seletor usado para filtrar a lista de anúncios nesta conta.
orçamentos	BudgetSelector	Obtém um seletor usado para filtrar a lista de orçamentos compartilhados nesta conta.
Campanhas	CampaignSelector	Obtém um seletor usado para filtrar a lista de campanhas nesta conta.
createLabel(nome da cadeia, descrição da cadeia, cor de fundo da cadeia)	Void	Cria uma etiqueta.
conta corrente	Conta	Obtém a conta que o script está processando no momento.
getExecutionInfo	ExecutionInfo	Devolve informações sobre o ambiente no qual o script está atualmente a ser executado.
Palavras-chave	KeywordSelector	Obtém um seletor usado para filtrar a lista de palavras-chave nesta conta.
etiquetas	LabelSelector	Obtém um seletor usado para filtrar a lista de rótulos nesta conta.
negativeKeywordLists	NegativeKeywordListSelector	Obtém um seletor usado para filtrar a lista de listas de palavras-chave negativas nesta conta.
newNegativeKeywordListBuilder	NegativeKeywordListBuilder	Obtém um construtor usado para adicionar uma lista de palavras-chave negativas a esta conta.
performanceMaxCampaigns	CampaignSelector	Obtém um seletor usado para filtrar a lista de campanhas de desempenho máximo nesta conta.
Grupos de Produtos	ProductGroupSelector	Obtém um seletor usado para filtrar a lista de grupos de produtos nesta conta.
shoppingAdGroups	AdGroupSelector	Obtém um seletor usado para filtrar a lista de grupos de anúncios usados para fazer compras nessa conta.
comprasCampanhas	CampaignSelector	Obtém um seletor usado para filtrar a lista de campanhas usadas para compras nesta conta.
Listas de Utilizadores	UserListSelector	Obtém um seletor usado para filtrar a lista de listas de usuários nesta conta.

Grupos de Anúncios

Obtém um seletor usado para filtrar a lista de grupos de anúncios nessa conta.

Devoluções

Tipo	Descrição
AdGroupSelector	Um seletor usado para filtrar a lista de grupos de anúncios na conta atual.

anúncios

Obtém um seletor usado 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 usado para filtrar a lista de orçamentos compartilhados nesta conta.

Este método devolve apenas orçamentos partilhados. Para obter orçamentos não partilhados (campanhas individuais), chame o método getBudget específico da campanha. O orçamento da campanha não será partilhado se o isExplicitlyShared método devolver false.

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 usado 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, cor de fundo da cadeia)

Cria uma etiqueta.

Para conhecer os limites do número de etiquetas que pode criar por conta, consulte Limites. Para obter um exemplo que adiciona uma etiqueta a uma conta, consulte Utilizar etiquetas.

Argumentos

Name	Tipo	Descrição
cor de fundo	cadeia	Opcional. A cor de fundo a utilizar na experiência de utilizador da etiqueta. Pode especificar a cor utilizando: Um número hexadecimal de três bytes no formato, #RRGGBB. Por exemplo, #CB0400. Um dos 16 nomes de cores CSS conhecidos. Por exemplo, aqua, amarelo e fúcsia. Tenha em consideração a acessibilidade ao escolher a cor. Se não for especificada, será escolhida uma cor aleatória para si.
Descrição	cadeia	Opcional. Uma descrição que descreve a utilização do rótulo. O tamanho máximo é de 200 carateres. Se especificar backgroundColor, tem de fornecer uma descrição ou uma cadeia vazia ("").
Designação	cadeia	Obrigatório. O nome da etiqueta. O nome é sensível a maiúsculas e minúsculas e tem de ser exclusivo na conta. O tamanho máximo é de 80 carateres. O método corta espaços em branco à esquerda e à direita do nome.

Devoluções

Tipo	Descrição
Void	Não devolve nada.

conta corrente

Obtém a conta que o script está processando no momento.

Nota

Para utilizar este método num cenário com múltiplas contas, selecione primeiro uma conta para gerir. Se chamar este método antes de selecionar uma conta, a chamada devolve um valor nulo.

Devoluções

Tipo	Descrição
Conta	A conta que o script está a processar atualmente. Para ver como usar isso em um cenário de várias contas, consulte o método de seleção de AccountsApp.

getExecutionInfo

Devolve informações sobre o ambiente no qual o script está atualmente a ser executado.

Devoluções:

Tipo	Descrição
ExecutionInfo	Informações sobre o ambiente no qual o script está sendo executado no momento.

Palavras-chave

Obtém um seletor usado 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 usado para filtrar a lista de rótulos nesta conta.

Devoluções

Tipo	Descrição
LabelSelector	Um seletor utilizado para filtrar a lista de etiquetas na conta atual.

negativeKeywordLists

Obtém um seletor usado 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 usado 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 usado para filtrar a lista de campanhas usadas para 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 corrente.

Grupos de Produtos

Obtém um seletor usado 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 corrente.

shoppingAdGroups

Obtém um seletor usado para filtrar a lista de grupos de anúncios usados para fazer compras nessa conta.

Devoluções

Tipo	Descrição
AdGroupSelector	Um seletor usado para filtrar a lista de grupos de anúncios usados para fazer compras na conta atual.

comprasCampanhas

Obtém um seletor usado para filtrar a lista de campanhas usadas para 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.

Listas de Utilizadores

Obtém um seletor usado para filtrar a lista de listas de usuários 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 conta única