Note di rilascio dell'API Merchant Accounts

Settimana del 26 ottobre 2026

  • È stata chiarita la documentazione per il metodo accounts.homepage.unclaim e il campo claimed della risorsa Homepage. Se un account eredita la rivendicazione della home page dal suo account avanzato, unclaim restituisce una risposta positiva, ma la home page rimane rivendicata. Se l'account stesso è esente dalla rivendicazione, unclaim restituisce un errore FAILED_PRECONDITION.

Settimana del 28 settembre 2026

  • Lancio della versione alpha del servizio LoyaltyPrograms che puoi utilizzare per gestire i programmi fedeltà. Questa funzionalità è disponibile solo per alcuni commercianti. Per saperne di più, consulta la Panoramica dei programmi fedeltà.

  • È stato aggiunto il campo di sola lettura home_page_uri alla risorsa accounts per restituire l'URI della home page del negozio.

Settimana del 3 agosto 2026

  • Aggiunta di "ucp_checkout_management" come tipo di servizio alla risorsa del servizio dell'account. Nota: l'acquisto rapido UCP è una funzionalità con accesso limitato.
  • È stato aggiunto il supporto per il programma "ucp-integration" (accesso limitato).
  • Aggiunto il supporto per il tipo di Termini di servizio "ucp_integration".

Settimana del 29 giugno 2026

  • Lancio del filtro access utilizzato nell'endpoint dell'elenco degli account. Questa funzionalità ti consente di filtrare gli account in base al tuo livello di accesso, con valori possibili DIRECT, INDIRECT e ALL. Il comportamento predefinito è restituire tutti gli account a cui hai accesso. Per saperne di più, consulta Filtra gli account a cui puoi accedere.

Settimana del 20 aprile 2026

  • Aggiunta di youtube-affiliate all'elenco dei nomi dei programmi disponibili alla descrizione della risorsa accounts.programs.
  • Attiva l'API del programma per il programma di affiliazione di YouTube Shopping. Disponibile per i trusted tester.

Settimana del 6 aprile 2026

  • Aggiunto lo stato WAITING a Stato di approvazione. Per i Servizi di shopping comparativo (CSS), WAITING è uno stato di transizione tra PENDING e ESTABLISHED. Utilizzato quando il CSS originale richiede tempo per eseguire le operazioni di pulizia necessarie prima che l'account venga trasferito completamente al nuovo CSS.

Settimana del 16 marzo 2026

  • Lanciato il metodo CreateTestAccount nell'API Accounts. In questo modo, gli sviluppatori possono creare in modo programmatico account di test dedicati che operano in un ambiente isolato simile a una sandbox, offrendo uno spazio sicuro per sviluppare e testare le integrazioni.

Settimana del 17 novembre 2025

  • CreateAndConfigureAccountRequest ora offre nuovi servizi che possono essere configurati durante la creazione dell'account. È necessario specificare esattamente uno dei seguenti elementi: AccountAggregation, AccountManagement e ComparisonShopping. Inoltre, è possibile specificare un numero arbitrario di servizi ProductsManagement e CampaignsManagement. Tuttavia, non devono esistere due servizi di questo tipo con gli stessi ID provider e ID account esterno.

  • Il metodo AccountsService.CreateAndConfigure ora fornisce un'impostazione per controllare se deve essere inviata un'email di verifica.

  • CreateAndConfigureAccountRequest.AddAccountService ora ha un campo external_account_id (questo campo esiste già nella risorsa AccountService). Può essere specificato insieme ai servizi CampaignsManagement e ProductsManagement.

  • È stato aggiunto un servizio ComparisonShopping alla risorsa AccountService. Per maggiori dettagli, consulta la pagina https://support.google.com/merchants/answer/12653197.

  • Ora è possibile impostare un alias per una relazione durante la creazione dell'account utilizzando il campo setAlias in CreateAndConfigureAccountRequest.

  • È stato aggiunto un metodo VerifySelf a UserService che consente di aggiornare lo stato da PENDING a VERIFIED per la risorsa User che rappresenta l'utente che effettua la chiamata.

  • Lanciare il nuovo campo radius_area nel payload Region dell'API Regions, che consentirà ai commercianti di creare una regione utilizzando un'area di raggio.

Settimana del 10 novembre 2025

  • Pubblica la versione v1alpha per l'API Services.
  • Lanciare il nuovo campo product_filters nel payload CampaignManagement dell'API Services che consentirà ai commercianti di condividere solo un sottoinsieme del loro feed con gli account Google Ads, in base ad alcuni filtri condizionali sugli attributi dei prodotti del commerciante. Questa funzionalità è inclusa nella lista consentita ed è accessibile solo a un numero limitato di commercianti.

Settimana del 25 agosto 2025

  • Nuovi metodi batch aggiunti all'API Regions:
    • BatchCreateRegions: consente di creare più regioni in un'unica richiesta.
    • BatchUpdateRegions: consente di aggiornare più regioni in un'unica richiesta.
    • BatchDeleteRegions: consente di eliminare più regioni per nome in un'unica richiesta.

Settimana del 1° luglio 2025

  • Lancio della risorsa CheckoutSettings che consente agli utenti dell'API di creare, aggiornare, eliminare e recuperare checkoutSettings.

Settimana del 26 maggio 2025

  • Ora è possibile filtrare gli account per capabilities. Al momento l'unico valore possibile è CAN_UPLOAD_PRODUCTS. Questo filtro ti consente di recuperare gli account che possono caricare prodotti. Ciò significa che ora è possibile utilizzare le seguenti clausole a livello di account:

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS Per saperne di più, consulta la guida ai filtri.

  • Lancio del diritto di accesso di sola lettura. Gli utenti con diritto di accesso di sola lettura possono visualizzare i dati del commerciante, ma non possono modificarli.

Settimana del 19 maggio 2025

  • Documentazione aggiornata per l'API Program, con la rimozione dell'affermazione errata secondo cui i metodi Enable/Disable sono limitati agli utenti amministratori.

Settimana del 12 maggio 2025

  • Lancio della risorsa Online Return Policy, che consente agli utenti dell'API di creare, aggiornare ed eliminare le norme sui resi.
  • Lancio di OmnichannelSettingsService e della risorsa OmnichannelSetting, che consente agli utenti dell'API di gestire la propria esperienza omnicanale.
  • Lancio di LfpProvidersService e della risorsa LfpProvider che consente agli utenti dell'API di gestire la propria relazione di partnership per i feed locali.
  • Lancio di GbpAccountsService e della risorsa GbpAccount che consente agli utenti dell'API di gestire il proprio profilo dell'attività su Google.
  • Lancia il tipo di servizio LocalListingManagement in AccountService, che collega il gruppo di sedi utilizzato per gli annunci di inventario locale o le schede locali senza costi.

Settimana del 28 aprile 2025

  • Lancio delle risorse AccountService e AccountRelationship che consentono agli utenti dell'API di gestire le relazioni e stabilire servizi con i fornitori di servizi.

Settimana del 14 aprile 2025

  • TermsOfServiceService.AcceptTermsOfService ora restituisce il valore TermsOfServiceAgremeentState accettato, inserito in un tipo di risposta.

  • Il verbo dell'azione TermsOfServiceService.AcceptTermsOfService ora è POST (in precedenza era GET).

  • Chiarito che AccountsService.ListSubAccounts deve essere chiamato utilizzando il formato accounts/... (anziché providers/...). In questo modo, questo metodo non esce dall'ambito accounts (ovvero GET accounts/123:listSubAccounts anziché GET providers/123:listSubAccounts).

Settimana del 31 marzo 2025

  • Per filtrare gli account, il filtro externalAccountId è stato dichiarato deprecato nella settimana del 2 dicembre 2024 e ora non è più disponibile. Ciò significa che ora il filtro per externalAccountId è possibile solo a livello di service. Un filtro come relationship(externalAccountId = "foo") non funzionerà più e deve essere espresso come relationship(service(externalAccountId = "foo")).

  • Chiarito nella documentazione di AccountsService che non è possibile creare account autonomi.

Settimana del 3 marzo 2025

-La accounts.onlineReturnPolicies#SeasonalOverride è stata rifattorizzata per migliorare la chiarezza e la coerenza. Questi aggiornamenti includono:

  • Ridenominazione dei campi:
    • begin è ora start_date.
    • end è ora end_date.
  • Rimozione dei campi:
    • Il campo deprecato policy è stato rimosso.

- Gli sviluppatori devono aggiornare il proprio codice per riflettere queste modifiche.

Lancio del servizio AutomaticImprovements che puoi utilizzare per gestire quanto segue:

Per saperne di più, consulta Attiva i miglioramenti automatici.

Settimana del 17 febbraio 2025

Rimosso il predicato callerHasAccessToProviderFilter() dal filtro dell'account.

Settimana del 10 febbraio 2025

  • Documentazione migliorata per il metodo AccountsService.List. Restituisce tutti gli account a cui l'utente ha accesso, non solo gli account autonomi.

  • È stata aggiunta una scadenza predefinita di 10 minuti per tutti i metodi RPC.

  • Aggiunto l'elenco dei nomi dei programmi disponibili alla descrizione della risorsa accounts.programs.

  • User.accessRights è ora REQUIRED e interessa sia il metodo UserService.Create sia il metodo AccountsService.CreateAndConfigure.

Settimana del 27 gennaio 2025

AccountsService.ListAccounts (e, in modo transitivo, AccountsService.ListSubAccounts) ora restituiscono gli account in modo coerente, anziché essere una lettura forte.

Settimana del 20 gennaio 2025

Il campo users di CreateAndConfigureAccountRequest è stato ritirato a favore di un nuovo user. Il CreateUserRequest a cui è stato fatto riferimento contiene il campo parent, che non è obbligatorio nel contesto di CreateAndConfigureAccountRequest.

Settimana del 6 gennaio 2025

Il campo user del messaggio CreateUserRequest è ora contrassegnato correttamente come OPTIONAL.

Il campo domain negli errori restituiti ora viene compilato con merchantapi.googleapis.com anziché global

Settimana del 2 dicembre 2024

Per filtrare gli account, il predicato externalAccountId viene spostato dal livello relationship al livello service. Pertanto, un filtro relationship(externalAccountId = "foo") ora deve essere scritto come relationship(service(externalAccountId = "foo")). Il vecchio formato è ancora supportato per la compatibilità con le versioni precedenti, ma è deprecato e genererà un errore nel prossimo futuro. Tutta la documentazione menzionerà solo il nuovo formato.

Settimana del 18 novembre 2024

Il provider nel campo CreateAndConfigureAccountRequest.service.provider ora può anche essere uno tra providers/GOOGLE_ADS o providers/GOOGLE_BUSINESS_PROFILE. Gli altri account devono essere indicati come providers/123 (anziché accounts/123). Ciò significa che il campo non è più annotato come riferimento all'account. Tuttavia, è ancora possibile utilizzare nomi di account come accounts/123 per la compatibilità con le versioni precedenti.

Il provider in ListSubAccountsRequest ora dovrebbe avere il formato providers/123, ma per la compatibilità con le versioni precedenti sarà comunque possibile utilizzare accounts/123.

Settimana del 4 novembre 2024

Contrassegna promotions_consent REQUIRED (da OPTIONAL) nella risorsa BusinessIdentity. Questo influisce solo sul metodo di aggiornamento. Ti informiamo che non è possibile aggiornare promotions_consent a UNSPECIFIED. Questa operazione non era già possibile, ma ora l'errore è più descrittivo e il campo è annotato correttamente.

Settimana del 28 ottobre 2024

Miglioramento della documentazione di varie risorse dell'API secondaria Accounts, come User, Homepage, BusinessInfo e così via.

Settimana del 21 ottobre 2024

Migliorare la documentazione dei campi update_mask nelle richieste di aggiornamento per indicare in modo specifico quali campi sono supportati per l'aggiornamento.

Aggiunto il link al Centro assistenza Google Business per gli operatori supportati al documento esterno della risorsa ShippingSettings

Settimana del 14 ottobre 2024

Contrassegna provider come REQUIRED in AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

Rendi update_mask facoltativo in tutta la sub-API Accounts (ad es. identità aziendale, informazioni sull'attività, home page e così via) e retroattivamente per la risorsa ConversionSources.

Parametro overwrite aggiunto a ClaimHomepageRequest.

Settimana del 30 settembre 2024

Lancio del parametro "force" per il metodo "Accounts.delete".

Settimana del 23 settembre 2024

Contrassegna region_code e kind come REQUIRED in RetrieveLatestTermsOfServiceRequest.

Settimana del 16 settembre 2024

Modificato il tipo di parametro time_zone in stringa in ListAccountIssuesRequest

Settimana del 12 agosto 2024

È stato aggiunto il campo korean_business_registration_number alla risorsa BusinessInfo.

Settimana del 27 maggio 2024

Lancio della versione beta della sub-API Accounts