Notas da versão da API Merchant Accounts

Semana de 17 de novembro de 2025

  • Agora, o CreateAndConfigureAccountRequest oferece novos serviços que podem ser configurados durante a configuração da conta. É preciso especificar exatamente um entre 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 campo external_account_id (que já existe no recurso AccountService). Ele pode ser especificado com os serviços CampaignsManagement e ProductsManagement.

  • Adicionamos um serviço ComparisonShopping ao recurso AccountService. Acesse https://support.google.com/merchants/answer/12653197 para mais detalhes.

  • Agora é possível definir um alias para uma relação 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 no recurso User que representa o usuário que está fazendo a chamada.

Semana de 10 de novembro de 2025

  • Publicar a 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 contas do Google Ads, com base em alguma filtragem condicional nos atributos dos produtos do comerciante. Esse recurso está na lista de permissões e só pode ser acessado por um número limitado de comerciantes.

Semana de 25 de agosto de 2025

  • Novos métodos em 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: permite 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 aos usuários da API criar, atualizar, excluir e receber 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. Com ele, é possível 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 direito de acesso somente leitura podem ver os dados do comerciante, mas não podem modificá-los.

Semana de 19 de maio de 2025

  • Atualizamos a documentação da API de programação, 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 de política de devolução on-line, que permite aos usuários da API criar, atualizar e excluir políticas de devolução.
  • Lançamento do OmnichannelSettingsService e do recurso OmnichannelSetting, que permite que os usuários da API gerenciem a experiência omnichannel.
  • Lançamento do LfpProvidersService e do recurso LfpProvider, que permite que os usuários da API gerenciem a relação de parceria de feeds locais.
  • Lançamento do GbpAccountsService e do recurso GbpAccount, que permite aos usuários da API gerenciar o Perfil da Empresa no Google.
    • Inicie o tipo de serviço LocalListingManagement em 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 envolvido em um tipo de resposta.

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

  • Esclarecemos que AccountsService.ListSubAccounts precisa ser chamado usando o formato accounts/... (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 está indisponí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")).

  • Esclarecemos na documentação do AccountsService 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:

  • 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

Removeu o predicado callerHasAccessToProviderFilter() do filtro de conta.

Semana de 10 de fevereiro de 2025

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

  • Adicionado prazo padrão de 10 minutos para todos os métodos RPC.

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

  • 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 retornam contas de maneira eventualmente consistente em vez de uma leitura forte.

Semana de 20 de janeiro de 2025

O campo users de 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 predicado externalAccountId é movido do nível relationship para o nível service. Portanto, um filtro relationship(externalAccountId = "foo") agora precisa ser escrito como relationship(service(externalAccountId = "foo")). O formato antigo ainda é compatível para compatibilidade 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 também pode ser providers/GOOGLE_ADS ou providers/GOOGLE_BUSINESS_PROFILE. Outras contas devem ser chamadas de 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 em 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

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

Semana de 28 de outubro de 2024

Melhorar a 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

Melhoramos a documentação dos campos update_mask nas solicitações de atualização para especificar quais campos são compatíveis com a atualização.

Adicionamos o link da Central de Ajuda do Google Business 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 de contas (por exemplo, identidade comercial, informações comerciais, página inicial etc.) e retroativamente para o recurso ConversionSources.

Adição do parâmetro overwrite a 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

Marque region_code e kind como REQUIRED em RetrieveLatestTermsOfServiceRequest.

Semana de 16 de setembro de 2024

O tipo do parâmetro time_zone foi mudado para string no ListAccountIssuesRequest

Semana de 12 de agosto de 2024

Adicionamos o campo korean_business_registration_number ao recurso BusinessInfo.

Semana de 27 de maio de 2024

Lançamento Beta da sub-API Accounts