Notas da versão da API Merchant Accounts

Semana de 29 de junho de 2026

  • Lançamento do filtro access usado no endpoint da lista de contas. Esse recurso permite filtrar contas com base no seu nível de acesso, com os valores possíveis DIRECT, INDIRECT e ALL. O comportamento padrão é retornar todas as contas a que você tem acesso. Para mais informações, consulte Filtrar contas a que você tem acesso.

Semana de 20 de abril de 2026

  • Adição de youtube-affiliate à lista de nomes de programas disponíveis para a descrição do recurso accounts.programs.
  • Ativação da API do programa para afiliados do YouTube Shopping. Disponível para trusted testers.

Semana de 6 de abril de 2026

  • Adição do estado WAITING ao estado de aprovação. Para serviços de comparação de preços (CSS), WAITING é um estado de transição entre PENDING e ESTABLISHED. Usado quando o CSS original precisa de tempo para realizar a limpeza necessária antes que a conta seja totalmente transferida para o novo CSS.

Semana de 16 de março de 2026

  • Lançamento do método CreateTestAccount na API Accounts. Isso permite que os desenvolvedores criem contas de teste dedicadas de maneira programática que operam em um ambiente isolado semelhante a um sandbox, oferecendo um espaço seguro para desenvolver e testar integrações.

Semana de 17 de novembro de 2025

  • Agora, CreateAndConfigureAccountRequest oferece novos serviços que podem ser configurados durante a configuração da conta. É necessário especificar exatamente um dos seguintes: AccountAggregation, AccountManagement e ComparisonShopping. Além disso, é possível especificar um número arbitrário de serviços ProductsManagement e CampaignsManagement. No entanto, não pode haver dois serviços com o mesmo provedor e IDs de conta externa.

  • O método AccountsService.CreateAndConfigure agora oferece uma configuração para controlar se um e-mail de verificação deve ser enviado.

  • CreateAndConfigureAccountRequest.AddAccountService agora tem um external_account_id campo (esse campo já existe no recurso AccountService) . Ele pode ser especificado com os serviços CampaignsManagement e ProductsManagement.

  • Adição de um serviço ComparisonShopping ao recurso AccountService. Consulte https://support.google.com/merchants/answer/12653197 para mais detalhes.

  • Agora é possível definir um alias para um relacionamento durante a criação da conta usando o campo setAlias em CreateAndConfigureAccountRequest.

  • Adição de um método VerifySelf ao UserService que permite atualizar o estado de PENDING para VERIFIED para o recurso User que representa o usuário que está fazendo a chamada.

  • Lançamento do novo campo radius_area no payload Region da API Regions, que permite que os comerciantes criem regiões usando a área de raio.

Semana de 10 de novembro de 2025

  • Publicação da versão v1alpha da API Services.
  • Lançamento do novo campo product_filters no payload CampaignManagement da API Services, que permite que os comerciantes compartilhem apenas um subconjunto do feed com as contas do Google Ads, com base em alguma filtragem condicional nos atributos dos produtos do comerciante. Esse é um recurso da lista de permissões acessível apenas a um número limitado de comerciantes.

Semana de 25 de agosto de 2025

  • Novos métodos de lote adicionados à API Regions:
    • BatchCreateRegions: permite criar várias regiões em uma única solicitação.
    • BatchUpdateRegions: permite atualizar várias regiões em uma única solicitação.
    • BatchDeleteRegions: oferece a capacidade de excluir várias regiões por nome em uma única solicitação.

Semana de 1º de julho de 2025

  • Lançamento do recurso CheckoutSettings, que permite que os usuários da API criem, atualizem, excluam e recebam checkoutSettings.

Semana de 26 de maio de 2025

  • Agora é possível filtrar contas por capabilities. No momento, o único valor possível é CAN_UPLOAD_PRODUCTS. Esse filtro permite recuperar contas que podem fazer upload de produtos. Isso significa que as seguintes cláusulas agora podem ser usadas no nível da conta:

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS Para mais informações, consulte o guia de filtragem.

  • Lançamento do direito de acesso somente leitura. Os usuários com o direito de acesso somente leitura podem visualizar os dados do comerciante, mas não podem modificá-los.

Semana de 19 de maio de 2025

  • Documentação atualizada para a API do programa, removendo a declaração incorreta de que os métodos Enable/Disable são restritos a usuários administradores.

Semana de 12 de maio de 2025

  • Lançamento do recurso Política de devolução on-line, que permite que os usuários da API criem, atualizem e excluam políticas de devolução.
  • Lançamento do recurso OmnichannelSettingsService e OmnichannelSetting, que permite que os usuários da API gerenciem a experiência omnichannel.
  • Lançamento do recurso LfpProvidersService e LfpProvider, que permite que os usuários da API gerenciem o relacionamento de parceria de feeds locais.
  • Lançamento do recurso GbpAccountsService e GbpAccount, que permite que os usuários da API gerenciem o Perfil da Empresa no Google.
  • Lançamento do tipo de serviço LocalListingManagement no AccountService, que vincula o grupo empresarial usado para anúncios de inventário local ou listagens locais sem custo financeiro.

Semana de 28 de abril de 2025

  • Lançamento dos recursos AccountService e AccountRelationship, que permitem que os usuários da API gerenciem relacionamentos e estabeleçam serviços para provedores de serviços.

Semana de 14 de abril de 2025

  • TermsOfServiceService.AcceptTermsOfService agora retorna o TermsOfServiceAgremeentState aceito, encapsulado em um tipo de resposta.

  • O verbo da ação TermsOfServiceService.AcceptTermsOfService agora é POST (antes era GET).

  • Esclarecimento de que AccountsService.ListSubAccounts precisa ser chamado usando o accounts/... formato (em vez de providers/...). Isso evita que esse método saia do escopo accounts (ou seja, GET accounts/123:listSubAccounts em vez de GET providers/123:listSubAccounts).

Semana de 31 de março de 2025

  • Para filtrar contas, o filtro externalAccountId foi anunciado como descontinuado na semana de 2 de dezembro de 2024 e agora não está disponível. Isso significa que a filtragem por externalAccountId agora só é possível no nível service. Um filtro como relationship(externalAccountId = "foo") não vai mais funcionar e precisa ser expresso como relationship(service(externalAccountId = "foo")).

  • Esclarecimento na documentação do AccountsService de que não é possível criar contas independentes.

Semana de 3 de março de 2025

-O accounts.onlineReturnPolicies#SeasonalOverride foi refatorado para melhorar a clareza e a consistência. Essas atualizações incluem o seguinte:

  • **Renomeação de campos**:
    • begin agora é start_date.
    • end agora é end_date.
  • Remoção de campos:
    • O campo policy descontinuado foi removido.

-Os desenvolvedores precisam atualizar o código para refletir essas mudanças.

Lançamento do serviço AutomaticImprovements, que pode ser usado para gerenciar o seguinte:

Para mais informações, consulte Ativar melhorias automáticas.

Semana de 17 de fevereiro de 2025

Remoção do predicado callerHasAccessToProviderFilter() do filtro de conta.

Semana de 10 de fevereiro de 2025

  • Documentação aprimorada para o método AccountsService.List. Ele retorna todas as contas a que o usuário tem acesso, não apenas contas independentes.

  • Adição de um prazo padrão de 10 minutos para todos os métodos RPC.

  • Adição da lista de nomes de programas disponíveis à accounts.programs descrição do recurso.

  • User.accessRights agora é REQUIRED, afetando os métodos UserService.Create e AccountsService.CreateAndConfigure.

Semana de 27 de janeiro de 2025

AccountsService.ListAccounts (e, transitivamente, AccountsService.ListSubAccounts) agora retorna contas de maneira consistente eventual, em vez de ser uma leitura forte.

Semana de 20 de janeiro de 2025

O campo users do CreateAndConfigureAccountRequest foi descontinuado em favor de um novo user. O CreateUserRequest referenciado contém o campo parent, que não é obrigatório no contexto do CreateAndConfigureAccountRequest.

Semana de 6 de janeiro de 2025

O campo user da mensagem CreateUserRequest agora está marcado corretamente como OPTIONAL.

O campo domain nos erros retornados agora é preenchido com merchantapi.googleapis.com em vez de global.

Semana de 2 de dezembro de 2024

Para filtrar contas, o externalAccountId predicado é movido do relationship nível para o service nível. Portanto, um filtro relationship(externalAccountId = "foo") agora precisa ser escrito como relationship(service(externalAccountId = "foo")). O formato antigo ainda é compatível com versões anteriores, mas está descontinuado e vai gerar um erro em breve. Toda a documentação vai mencionar apenas o novo formato.

Semana de 18 de novembro de 2024

O provedor no campo CreateAndConfigureAccountRequest.service.provider agora também pode ser um de providers/GOOGLE_ADS ou providers/GOOGLE_BUSINESS_PROFILE. Outras contas precisam ser referidas como providers/123 (em vez de accounts/123). Isso significa que o campo não é mais anotado como uma referência de conta. No entanto, ainda é possível usar nomes de contas como accounts/123 para compatibilidade com versões anteriores.

O provedor no ListSubAccountsRequest agora precisa estar no formato providers/123, mas, para compatibilidade com versões anteriores, ainda será possível usar accounts/123.

Semana de 4 de novembro de 2024

Marcar promotions_consent como REQUIRED (de OPTIONAL) no recurso BusinessIdentity. Isso afeta apenas o método de atualização. Isso serve para esclarecer que não é possível atualizar promotions_consent para UNSPECIFIED. Isso já não era possível, mas o erro agora é mais descritivo e o campo está anotado corretamente.

Semana de 28 de outubro de 2024

Melhoria da documentação de vários recursos da sub-API Accounts, como User, Homepage, BusinessInfo e assim por diante.

Semana de 21 de outubro de 2024

Melhoria da documentação dos campos update_mask em solicitações de atualização para indicar especificamente quais campos são compatíveis com a atualização.

Adição do link da Central de Ajuda do Google para operadoras compatíveis ao documento externo do recurso ShippingSettings.

Semana de 14 de outubro de 2024

Marcar provider como REQUIRED em AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

Tornar update_mask opcional em toda a sub-API Accounts (por exemplo, identidade comercial, informações comerciais, página inicial etc.) e retroativamente para o recurso ConversionSources.

Adição do parâmetro overwrite ao ClaimHomepageRequest.

Semana de 30 de setembro de 2024

Lançamento do parâmetro "force" para o método "Accounts.delete".

Semana de 23 de setembro de 2024

Marcar region_code e kind como REQUIRED em RetrieveLatestTermsOfServiceRequest.

Semana de 16 de setembro de 2024

Mudança do tipo de parâmetro time_zone para string no ListAccountIssuesRequest.

Semana de 12 de agosto de 2024

Adição do campo korean_business_registration_number ao recurso BusinessInfo.

Semana de 27 de maio de 2024

Lançamento Beta da sub-API Accounts