Esta página mostra as notas da versão da API AdSense Management.
Versão 2
Esta versão apresenta as seguintes mudanças para remover a funcionalidade descontinuada e alinhar a API AdSense Management aos padrões atuais da API Google. De acordo com o esquema de versionamento da API Google, essa versão será atualizada ao longo do tempo para incluir mais funcionalidades (compatíveis com versões anteriores) em vez de novas funcionalidades lançadas em versões secundárias separadas.
2025-02-24
PolicyIssues
- Adicionamos um campo
policyTopics[].type
para identificar se um tema de política representa um problema com a política, um problema regulamentar ou uma preferência do anunciante. Isso substituipolicyTopics[].must_fix
, que agora é marcado como um campo descontinuado.
2024-04-03
PolicyIssues
- Adicionamos uma nova coleção para informar sobre violações de políticas atuais e avisos presentes em uma conta.
2023-06-19
Pagamentos
- payments.list agora retorna detalhes sobre pagamentos para editores premium.
2023-06-13
Relatórios
- Foram adicionadas as métricas
FUNNEL_REQUESTS
,FUNNEL_IMPRESSIONS
,FUNNEL_CLICKS
eFUNNEL_RPM
, que fornecem informações sobre a performance de unidades que não são de anúncios (por exemplo, unidades de pesquisa relacionadas).
2023-03-30
Relatórios
- Adicionamos a dimensão
PAGE_URL
, que permite que as métricas sejam detalhadas por URL da página (com algumas ressalvas, consulte Detalhes do URL da página).
2022-09-21
AdUnits
- Foram adicionados métodos de criação e patch. Esses métodos só podem ser usados por projetos ativados para o produto AdSense para plataformas.
CustomChannels
- Foram adicionados métodos de criação, correção e atualização. Esses métodos só podem ser usados por projetos ativados para o produto AdSense para plataformas.
- Adicionamos o campo ativo ao recurso.
Contas
- Adição do método getAdBlockingRecoveryTag.
2022-08-25
Relatórios
- Adicionamos a dimensão
HOSTED_AD_CLIENT_ID
, que permite que editores de host e de plataforma dividam as métricas por contas de editor (editores de host) e por subcontas (editores de plataforma).
2022-05-03
AdClient
- Adição do método get.
Relatórios
- Adição do método getSaved.
UrlChannels
- O método "get" foi adicionado.
2022-03-31
Conta
- As contas inativas agora são retornadas pela API, com um campo
state
que indica o estado da conta.
AdClient
- Assim como nas mudanças de conta acima, os clientes de anúncios inativos agora são retornados pela API, com um campo
state
que indica o estado do cliente de anúncio.
2022-02-24
Pagamento
-
O formato do nome do recurso foi estendido para oferecer suporte a recursos separados
para ganhos do YouTube. Essa mudança é anterior ao lançamento gradual da
experiência aprimorada do Google AdSense
para criadores de conteúdo do YouTube, em que os ganhos do YouTube serão separados
na própria conta para pagamentos. As informações de pagamento do YouTube também serão retornadas
pelo método de lista de pagamentos, assim que você tiver uma
conta para pagamentos
dedicada aos ganhos do YouTube.
Os ganhos do YouTube terão o seguinte formato de nome de recurso:
- accounts/{account}/payments/youtube-unpaid para ganhos não pagos (atual) do YouTube.
- accounts/{account}/payments/youtube-yyyy-MM-dd para ganhos pagos do YouTube.
Observação:os nomes dos recursos para os ganhos do Google AdSense não vão mudar:- accounts/{account}/payments/unpaid para ganhos pendentes (atual) do Google AdSense.
- accounts/{account}/payments/yyyy-MM-dd para ganhos pagos do Google AdSense.
2021-06-30
Relatório
- Foram adicionadas as dimensões
AD_FORMAT_NAME
eAD_FORMAT_CODE
, que indicam como um anúncio é mostrado aos usuários no seu site (na página, vinheta etc.). A v1.4 tinha dimensões (descontinuadas) com os mesmos nomes, mas membros diferentes. As duas dimensões adicionadas na v2 são diferentes daquelas que estavam presentes na v1.4.
2021-04-19 (versão inicial)
Geral
- Todos os métodos descontinuados na v1.4 foram removidos. Isso inclui métodos de recurso
que não exigiam um
accountId
. Na v2, oaccountId
é especificado no campoparent
. - De acordo com os padrões das APIs do Google, os recursos agora são identificados por um campo
name
. Por exemplo, o nome de um cliente de anúncios éaccounts/{accountId}/adclients/{adClientId}
. Além disso, na v1.4, o ID do recurso era usado como uma dimensão de relatórios, mas na v2 esse valor agora está disponível em um camporeporting_dimension_id
em vários recursos. - O campo
kind
foi removido de todos os recursos.
Conta
- O campo
name
foi alterado paradisplay_name
. - O campo
timezone
foi alterado de uma string para umgoogle.type.TimeZone
. - O campo
creation_time
(tipo int64) foi alterado paracreate_time
(tipogoogle.protobuf.Timestamp
). - Foi adicionado um campo
pending_tasks
, que é uma lista de tarefas pendentes que precisam ser concluídas como parte do processo de inscrição de uma nova conta. Por exemplo, as tarefas podem estar relacionadas ao seu perfil de faturamento ou à verificação de telefone. - O campo
sub_accounts
foi removido. Uma funcionalidade semelhante pode ser alcançada na v2 com o método personalizadolistChildAccounts
. A árvore completa de contas secundárias pode ser gerada na v2 chamandolistChildAccounts
de forma recursiva.
AdClient
- O campo
arc_opt_in
foi removido da interface do Google AdSense. - O campo
supports_reporting
é substituído pelo camporeporting_dimension_id
, que representa o ID exclusivo do cliente de anúncios conforme usado na dimensão de relatóriosAD_CLIENT_ID
. Sereporting_dimension_id
estiver vazio, o AdClient não vai oferecer suporte a relatórios.
AdUnit
- O campo
status
foi renomeado comostate
. Além disso, o estadoACTIVE
não indica mais se houve atividade nesse bloco de anúncios nos últimos sete dias. Na v2, significa que o bloco de anúncios foi ativado pelo usuário e pode veicular anúncios. - O campo
code
foi removido. Esse valor ainda pode ser encontrado no final do camponame
(após o último caractere de barra invertida). - O campo
contentAdsSettings.backupOption
foi removido. - O campo
type
foi restrito aos valoresTYPE_UNSPECIFIED
,DISPLAY
,FEED
,ARTICLE
,MATCHED_CONTENT
eLINK
. - Outros campos que já foram removidos na interface do Google AdSense também foram
removidos:
custom_style
,saved_style_id
,mobile_content_ads_settings
efeed_ads_settings
.
Alerta
- O método
delete
foi removido. - O campo
is_dismissible
foi removido. - O campo
locale
foi renomeado comolanguage_code
.
CustomChannel
- O campo
code
foi removido. Esse valor ainda pode ser encontrado no final do camponame
(após o último caractere de barra invertida). - O campo
targeting_info
foi removido porque já foi removido da interface do Google AdSense.
Pagamento
- O campo
payment_date
foi renomeado comodate
e alterado do tipo string paragoogle.type.Date
. - Os campos
payment_amount
epayment_amount_currency_code
foram combinados em um único campopayment
(por exemplo, "¥1.235 JPY", "$1.234,57", "£87,65").
Relatório
- Com a v2, os dados de relatórios da API AdSense Management agora estão alinhados à interface do AdSense. Isso significa que as propriedades da AdMob e do YouTube não são mais compatíveis. Além disso, a API só vai oferecer suporte a dados de relatórios de até três anos.
- Os recursos
Metadata.dimensions
eMetadata.metrics
foram removidos. - Foram adicionados novos métodos para gerar uma versão CSV do relatório, substituindo os parâmetros de consulta na v1.4. Observação: para compactação, ainda é possível usar o cabeçalho HTTP "Accept-Encoding: gzip".
-
Alguns campos foram alterados na geração de relatórios ad hoc.
- O campo
account_id
foi renomeado comoaccount
. - O campo
dimension
foi renomeado comodimensions
. - O campo
metric
foi renomeado comometrics
. - O campo
filter
foi renomeado comofilters
. - O campo
sort
foi renomeado comoorder_by
. - O campo
locale
foi renomeado comolanguage_code
. - O campo
currency
foi renomeado comocurrency_code
. - Agora é possível especificar vários intervalos comuns com
date_range
, por exemplo,TODAY
,YESTERDAY
,MONTH_TO_DATE
,YEAR_TO_DATE
,LAST_7_DAYS
eLAST_30_DAYS
) ou especificar umstart_date
eend_date
definindodate_range
comoCUSTOM
. - Os campos
start_date
eend_date
foram alterados do tipo string para o tipogoogle.type.Date
. Observação: como resultado, as palavras-chave de data relativa (por exemplo, "today-6d") não são mais compatíveis. - O campo booleano
use_timezone_reporting
foi substituído porreporting_time_zone
, que pode ter um dos dois valores:ACCOUNT_TIME_ZONE
ouGOOGLE_TIME_ZONE
(que significa PST/PDT). O padrão na v2 éACCOUNT_TIME_ZONE
, que é diferente do padrão na v1.4. - O campo
start_index
foi removido. - O campo
max_results
foi renomeado comolimit
.
- O campo
-
Alguns campos foram alterados na geração de relatórios salvos.
- Campos de data adicionados (
date_range
,start_date
,end_date
,reporting_time_zone
). - Campo
currency_code
adicionado. - O campo
locale
foi renomeado comolanguage_code
. - O campo
start_index
foi removido. - O campo
max_results
foi removido.
- Campos de data adicionados (
SavedAdStyle
SavedAdStyle
foi removido porque já foi removido da interface do Google AdSense.
Site
-
Sites
foram adicionados para buscar dados sobre sites que você adicionou à sua conta do Google AdSense. - O campo
state
representa se o site está em um dos seguintes estados:REQUIRES_REVIEW
,GETTING_READY
,READY
eNEEDS_ATTENTION
. - O campo
auto_ads_enabled
é um booleano que representa se os anúncios automáticos foram ativados em um site específico.
Versão 1.4
Esta versão apresenta as seguintes funcionalidades:
- Agora você pode listar os pagamentos da sua conta do Google AdSense na moeda correspondente.
- Agora é possível dispensar um alerta chamando o método
delete
, que vai ocultar o alerta na API e na interface da Web do Google AdSense. - A resposta do relatório agora inclui datas de início e término. Isso é importante
se você estiver usando datas relativas ao gerar relatórios (como
today
,yesterday
,firstDayOfMonth-1m
). A resposta agora inclui o período solicitado.
Problemas conhecidos
O campo currency
nos relatórios não é compatível com esta versão.
Versão 1.3
Esta versão apresenta as seguintes funcionalidades:
- A capacidade de recuperar alertas.
- A capacidade de recuperar metadados de métricas e dimensões.
- Gerar relatórios no fuso horário local da conta.
Problemas conhecidos
O campo currency
nos relatórios não é compatível com esta versão.
Versão 1.2
Esta versão apresenta as seguintes funcionalidades:
- A capacidade de recuperar estilos de anúncios.
- A capacidade de recuperar e executar os relatórios salvos definidos no front-end.
Problemas conhecidos
O campo currency
nos relatórios não é compatível com esta versão.
Versão 1.1
Esta versão apresenta as seguintes funcionalidades:
- A capacidade de listar contas a que o usuário tem acesso
- A capacidade de fazer uma chamada GET em uma conta específica
- A capacidade de realizar chamadas GET em blocos de anúncios e em canais personalizados
- A capacidade de determinar as conexões entre blocos de anúncios e canais personalizados
- Os canais personalizados contêm mais dados sobre as informações de segmentação
Além disso, agora você pode acessar dados na sua conta padrão ou em uma conta específica.
Problemas conhecidos
O campo currency
nos relatórios não é compatível com esta versão.
Versão 1
Esta é a primeira versão da API. Ela inclui suporte para recuperação de clientes de anúncios, blocos de anúncios, canais personalizados, critérios de URL, bem como para gerar relatórios.
Problemas conhecidos
O campo currency
nos relatórios não é compatível com esta versão.