Notas da versão da API Merchant Accounts

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 conferir os dados do comerciante, mas não podem modificá-los.

Semana de 19 de maio de 2025

  • Atualizamos a documentação da 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 de 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 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 parceria com a API Local Feeds.
  • Lançamento do GbpAccountsService e do recurso GbpAccount, que permite que os usuários da API gerenciem o Perfil da Empresa no Google.
    • Inicie o tipo de serviço LocalListingManagement no AccountService, que vincula o grupo de negócios 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 que foi aceito em um tipo de resposta.

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

  • Foi esclarecido que AccountsService.ListSubAccounts precisa ser chamado usando o formato accounts/... (em vez de providers/...). Isso evita que esse método saia do escopo accounts (o que significa 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 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")).

  • A documentação de AccountsService foi esclarecida para que não seja possível criar contas independentes.

Semana de 3 de março de 2025

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

  • Renomear campo:
    • begin agora é start_date
    • end agora é end_date
  • Remoção de campo:
    • 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

O predicado callerHasAccessToProviderFilter() foi removido do filtro da conta.

Semana de 10 de fevereiro de 2025

  • Melhoria na documentação do método AccountsService.List. Ele retorna todas as contas a que o usuário tem acesso, não apenas contas independentes.

  • Foi adicionado um 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 retorna contas de uma forma consistente eventual em vez de 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 em 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 para o nível service do nível relationship. Portanto, um filtro relationship(externalAccountId = "foo") agora precisa ser escrito como relationship(service(externalAccountId = "foo")). O formato antigo ainda tem suporte para compatibilidade com versões anteriores, mas foi 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 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 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 agora o erro é mais descritivo e o campo é corretamente anotado.

Semana de 28 de outubro de 2024

Melhoria na 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 na documentação dos campos update_mask em solicitações de atualização para indicar especificamente quais campos têm suporte para atualização.

Adicionamos o link da Central de Ajuda do Google Meu Negócio 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 da empresa, 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

region_code e kind foram marcados como REQUIRED em RetrieveLatestTermsOfServiceRequest.

Semana de 16 de setembro de 2024

O tipo do parâmetro time_zone foi alterado 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