Semana de 26 de outubro de 2026
- Esclarecimento da documentação do método
accounts.homepage.unclaime do campoclaimeddo recursoHomepage. Se uma conta herdar a reivindicação da página inicial da conta avançada,unclaimvai retornar uma resposta bem-sucedida, mas a página inicial vai continuar reivindicada. Se a conta estiver isenta de reivindicação,unclaimvai retornar um erroFAILED_PRECONDITION.
Semana de 28 de setembro de 2026
Adicionamos
youtube_affiliate_managementcomo um tipo de serviço ao recursoAccountServiceemv1alpha. Observação: o gerenciamento de afiliados do YouTube é um recurso com acesso limitado.Lançamento Alfa do serviço
LoyaltyProgramsque pode ser usado para gerenciar programas de fidelidade. Esse recurso está disponível apenas para alguns comerciantes. Para mais informações, consulte a Visão geral dos programas de fidelidade.Adicionamos o campo somente leitura
home_page_uriao recursoaccountspara retornar o URI da página inicial da loja.
Semana de 3 de agosto de 2026
- Adicionamos "ucp_checkout_management" como um tipo de serviço ao recurso de serviço da conta. Observação: a finalização de compra do UCP é um recurso com acesso limitado.
- Adicionamos suporte ao programa "ucp-integration" (acesso limitado).
- Adicionamos suporte ao tipo de Termos de Serviço "ucp_integration".
Semana de 29 de junho de 2026
- Lançamento do filtro
accessusado no endpoint da lista de contas. Esse recurso permite filtrar contas com base no seu nível de acesso, com os valores possíveis sendoDIRECT,INDIRECTeALL. O comportamento padrão é retornar todas as contas a que você tem acesso. Para mais informações, consulte Filtrar contas que você pode acessar.
Semana de 20 de abril de 2026
- Adicionamos
youtube-affiliateà lista de nomes de programas disponíveis para a descrição do recursoaccounts.programs. - Ative a API do programa para o Programa de Afiliados do YouTube Shopping. Disponível para trusted testers.
Semana de 6 de abril de 2026
- Adicionamos o estado
WAITINGao estado de aprovação. Para os Serviços de Comparação de Preços (CSS),WAITINGé um estado de transição entrePENDINGeESTABLISHED. Usado quando o CSS original precisa de tempo para realizar qualquer 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
CreateTestAccountna API Accounts. Isso permite que os desenvolvedores criem de forma programática contas de teste dedicadas 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
O
CreateAndConfigureAccountRequestagora oferece novos serviços que podem ser configurados durante a configuração da conta. É preciso especificar exatamente umAccountAggregation,AccountManagementouComparisonShopping. Além disso, é possível especificar um número arbitrário de serviçosProductsManagementeCampaignsManagement. No entanto, não pode haver dois serviços desse tipo com o mesmo provedor e IDs de conta externa.O método
AccountsService.CreateAndConfigureagora oferece uma configuração para controlar se um e-mail de verificação deve ser enviado.CreateAndConfigureAccountRequest.AddAccountServiceagora tem um campoexternal_account_id(que já existe no recursoAccountService). Ele pode ser especificado com os serviçosCampaignsManagementeProductsManagement.Adicionamos um serviço
ComparisonShoppingao recursoAccountService. 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
setAliasemCreateAndConfigureAccountRequest.Adição de um método
VerifySelfaoUserServiceque permite atualizar o estado dePENDINGparaVERIFIEDpara o recursoUserque representa o usuário que faz a chamada.Lançar o novo campo
radius_areano payloadRegionda API Regions, que vai permitir que os comerciantes criem regiões usando uma área de raio.
Semana de 10 de novembro de 2025
- Publique a versão v1alpha da API Services.
- Lançar o novo campo
product_filtersno payloadCampaignManagementda API Services, que vai permitir que os comerciantes compartilhem apenas um subconjunto do feed com as contas do Google Ads, com base em uma filtragem condicional nos atributos dos produtos do comerciante. Esse é um recurso da lista de permissões, acessível apenas para alguns 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: 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_PRODUCTSNOT capabilities:CAN_UPLOAD_PRODUCTSPara 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 do programa, removendo a declaração incorreta de que os métodos
Enable/Disablesã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 o relacionamento com o programa de parcerias 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 no AccountService, que vincula o grupo de unidades da empresa 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.AcceptTermsOfServiceagora retorna oTermsOfServiceAgremeentStateque foi aceito, encapsulado em um tipo de resposta.O verbo da ação
TermsOfServiceService.AcceptTermsOfServiceagora éPOST(antes eraGET).Esclarecemos que
AccountsService.ListSubAccountsprecisa ser chamado usando o formatoaccounts/...(em vez deproviders/...). Isso evita que esse método saia do escopoaccounts(ou seja,GET accounts/123:listSubAccountsem vez deGET providers/123:listSubAccounts).
Semana de 31 de março de 2025
Para filtrar contas, o filtro
externalAccountIdfoi anunciado como descontinuado na semana de 2 de dezembro de 2024 e agora está indisponível. Isso significa que a filtragem porexternalAccountIdagora só é possível no nívelservice. Um filtro comorelationship(externalAccountId = "foo")não vai mais funcionar e precisa ser expresso comorelationship(service(externalAccountId = "foo")).Esclarecemos na documentação do
AccountsServiceque 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:
beginagora éstart_dateendagora éend_date
- Remoção de campos:
- O campo
policydescontinuado foi removido.
- O campo
-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 de 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 as contas independentes.Adicionamos 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.accessRightsagora éREQUIRED, afetando os métodosUserService.CreateeAccountsService.CreateAndConfigure.
Semana de 27 de janeiro de 2025
AccountsService.ListAccounts (e, de forma transitiva,
AccountsService.ListSubAccounts) agora retornam contas de maneira consistente,
em vez de serem 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 predicado externalAccountId é movido do nível relationship para o nível service. Portanto, um filtro relationship(externalAccountId = "foo") agora precisaria ser
escrito como relationship(service(externalAccountId = "foo")). O formato antigo
ainda é compatível 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
agora também pode ser providers/GOOGLE_ADS ou
providers/GOOGLE_BUSINESS_PROFILE. Outras contas precisam 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 conta 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
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 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.
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
Marque 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 em
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