Esta página foi traduzida pela API Cloud Translation.

Notas da versão

Esta página fornece notas da versão para a API AdSense Management.

Versão 2

Esta versão apresenta as seguintes mudanças para remover funcionalidades descontinuadas e alinhar a API AdSense Management com os padrões atuais das APIs do Google. De acordo com o esquema de controle de versões da API do Google, essa versão será atualizada com o tempo para incluir mais funcionalidades (compatíveis com versões anteriores) em vez de novas funcionalidades serem lançadas em versões secundárias separadas.

2025-10-02

Relatórios

Adicionamos a dimensão TRAFFIC_SOURCE, que permite detalhar as métricas por origem de tráfego (por exemplo, "Google", "Bing", "Facebook", "Outro"). Para mais informações, consulte Detalhamento da origem de tráfego.

2025-05-06

PolicyIssues

O campo policyTopics[].must_fix descontinuado (consulte a atualização anterior) agora sempre será definido como false.

2025-02-24

PolicyIssues

Adicionamos um campo policyTopics[].type para identificar se um tópico da política representa um problema com a política, com a regulamentação ou uma preferência do anunciante. Isso substitui policyTopics[].must_fix, que agora está marcado como um campo descontinuado.

2024-04-03

PolicyIssues

Adicionamos uma nova coleção para gerar relatórios sobre violações e avisos de política atuais em uma conta.

2023-06-19

Pagamentos

Agora, payments.list retorna detalhes sobre pagamentos para editores premium.

2023-06-13

Relatórios

Adição das métricas FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS e FUNNEL_RPM, que fornecem informações sobre a performance de unidades que não são de anúncios (por exemplo, unidades de pesquisa relacionada).

2023-03-30

Relatórios

Adicionamos a dimensão PAGE_URL, que permite detalhar as métricas por URL da página (com algumas ressalvas, consulte Detalhamento do URL da página).

2022-09-21

AdUnits

Adição dos métodos "create" e "patch". Esses métodos só podem ser usados por projetos ativados para o produto AdSense para plataformas.

CustomChannels

Adição dos métodos create, patch e update. Esses métodos só podem ser usados por projetos ativados para o produto AdSense para plataformas.
Adicionamos o campo "active" 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 os editores de host e plataforma detalhem as métricas pelas contas do editor (editores de host) e pelas subcontas (editores de plataforma).

2022-05-03

AdClient

Adição do método "get".

Relatórios

Adição do método getSaved.

UrlChannels

Adição do método "get".

2022-03-31

Conta

As contas inativas agora são retornadas pela API com um campo state indicando o estado da conta.

AdClient

Assim como nas mudanças na conta, os clientes de anúncios inativos agora são retornados pela API com um campo state indicando o estado do cliente de anúncios.

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 AdSense para criadores de conteúdo do YouTube, em que os ganhos do YouTube serão separados em uma conta para pagamentos própria. As informações de pagamento do YouTube também serão retornadas pelo método da lista de pagamentos quando 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 (atuais) do YouTube.
- accounts/{account}/payments/youtube-yyyy-MM-dd para ganhos pagos do YouTube.
Observação:os nomes de recursos dos ganhos do Google AdSense permanecem inalterados:
- accounts/{account}/payments/unpaid para ganhos pendentes (atuais) do AdSense.
- accounts/{account}/payments/yyyy-MM-dd para ganhos pagos do AdSense.

2021-06-30

Denuncie

Adicionamos as dimensões AD_FORMAT_NAME e AD_FORMAT_CODE, que indicam a forma como um anúncio é veiculado 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 distintas daquelas presentes na v1.4.

19/04/2021 (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, o accountId é especificado no campo parent.
De acordo com os padrões da API do Google, os recursos agora são identificados por um campo name. Por exemplo, o nome de um AdClient seria 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 campo reporting_dimension_id em vários recursos.
O campo kind foi removido de todos os recursos.

Conta

O campo name foi alterado para display_name.
O campo timezone foi alterado de uma string para um google.type.TimeZone.
O campo creation_time (tipo int64) foi alterado para create_time (tipo google.protobuf.Timestamp).
Adicionamos um campo pending_tasks, que é uma lista de tarefas pendentes que precisam ser concluídas como parte do processo de inscrição para uma nova conta. Por exemplo, as tarefas podem estar relacionadas ao seu perfil para pagamentos ou à verificação por telefone.
O campo sub_accounts foi removido. Uma funcionalidade semelhante pode ser alcançada na v2 com o método personalizado listChildAccounts. A árvore completa de contas infantis pode ser gerada na v2 chamando listChildAccounts de forma recursiva.

AdClient

O campo arc_opt_in foi removido porque já tinha sido removido da interface do Google AdSense.
O campo supports_reporting é substituído pelo campo reporting_dimension_id, que representa o ID exclusivo do cliente de publicidade usado na dimensão de relatórios AD_CLIENT_ID. Se reporting_dimension_id estiver vazio, o AdClient não vai oferecer suporte a relatórios.

AdUnit

O campo status foi renomeado como state. Além disso, o estado ACTIVE não indica mais se houve atividade nesse bloco de anúncios nos últimos sete dias. Na v2, isso 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 campo name (depois da última barra).
O campo contentAdsSettings.backupOption foi removido.
O campo type foi restrito aos valores TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT e LINK.
Outros campos que já foram removidos da interface do AdSense também serão removidos: custom_style, saved_style_id, mobile_content_ads_settings e feed_ads_settings.

Alerta

O método delete foi removido.
O campo is_dismissible foi removido.
O campo locale foi renomeado como language_code.

CustomChannel

O campo code foi removido. Esse valor ainda pode ser encontrado no final do campo name (depois da última barra).
O campo targeting_info foi removido porque já tinha sido removido da interface do Google AdSense.

Pagamento

O campo payment_date foi renomeado como date e mudou do tipo string para o tipo google.type.Date.
Os campos payment_amount e payment_amount_currency_code foram combinados em um único campo payment (por exemplo, "¥1,235 JPY", "$1,234.57", "£87.65").

Denuncie

Com a v2, os dados de relatórios da API AdSense Management agora estão alinhados com a 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 dos últimos três anos.
Os recursos Metadata.dimensions e Metadata.metrics foram removidos.
Novos métodos foram adicionados para gerar uma versão CSV do relatório, substituindo os parâmetros de consulta na v1.4. Observação: para compactação, você ainda pode 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 como account.
- O campo dimension foi renomeado como dimensions.
- O campo metric foi renomeado como metrics.
- O campo filter foi renomeado como filters.
- O campo sort foi renomeado como order_by.
- O campo locale foi renomeado como language_code.
- O campo currency foi renomeado como currency_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 e LAST_30_DAYS) ou especificar um start_date e um end_date definindo date_range como CUSTOM.
- Os campos start_date e end_date foram mudados do tipo string para o tipo google.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 por reporting_time_zone, que pode ter um destes dois valores: ACCOUNT_TIME_ZONE ou GOOGLE_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 como limit.
Alguns campos foram alterados na geração de relatórios salvos.
- Adição de campos de data (date_range, start_date, end_date, reporting_time_zone).
- Adicionamos um campo currency_code.
- O campo locale foi renomeado como language_code.
- O campo start_index foi removido.
- O campo max_results foi removido.

SavedAdStyle

SavedAdStyle foi removido porque já tinha sido removido da interface do AdSense.

Site

Sites foram adicionados para buscar dados sobre os 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 ou NEEDS_ATTENTION.
O campo auto_ads_enabled é um booleano que representa se os anúncios automáticos foram ativados em um site específico.