Note di rilascio dell'API Merchant Accounts

Settimana del 3 agosto 2026

• È stato aggiunto "ucp_checkout_management" come tipo di servizio alla risorsa del servizio account. Nota: il checkout UCP è una funzionalità ad accesso limitato.
• È stato aggiunto il supporto per il programma "ucp-integration" (accesso limitato).
• È stato aggiunto il supporto per il tipo di termini di servizio "ucp_integration".

Settimana del 29 giugno 2026

• Lancio del filtro access utilizzato nell' endpoint della lista degli account. Questa funzionalità ti consente di filtrare gli account in base al tuo livello di accesso, con i possibili valori DIRECT, INDIRECT e ALL. Il comportamento predefinito è restituire tutti gli account a cui hai accesso. Per ulteriori informazioni, consulta Filtrare gli account a cui puoi accedere.

Settimana del 20 aprile 2026

• È stato aggiunto youtube-affiliate all'elenco dei nomi dei programmi disponibili nella 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

• È stato aggiunto lo stato WAITING allo stato di approvazione. Per i servizi di shopping comparativo (CSS), WAITING è uno stato di transizione tra PENDING e ESTABLISHED. Viene utilizzato quando il CSS originale richiede tempo per eseguire la pulizia necessaria prima che l'account venga trasferito completamente al nuovo CSS.

Settimana del 16 marzo 2026

• È stato lanciato il metodo CreateTestAccount nell'API Accounts. Consente agli sviluppatori di creare a livello di programmazione account di test dedicati che operano in un ambiente isolato simile a una sandbox, fornendo 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 configurazione dell'account. È necessario specificare esattamente uno tra AccountAggregation, AccountManagement e ComparisonShopping. Inoltre, è possibile specificare un numero arbitrario di servizi ProductsManagement e CampaignsManagement. Tuttavia, non devono esistere due servizi con lo stesso ID account esterno e provider.

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

• CreateAndConfigureAccountRequest.AddAccountService ora ha un external_account_id campo (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 ulteriori dettagli, consulta 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.

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

Settimana del 10 novembre 2025

• Pubblica la versione v1alpha dell'API Services.
• Lancia 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 a un filtro condizionale sugli attributi dei prodotti del commerciante. Questa è una funzionalità inclusa nella lista consentita 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 ottenere checkoutSettings.

Settimana del 26 maggio 2025

• Ora è possibile filtrare gli account per capabilities. Al momento l'unico valore possibile è CAN_UPLOAD_PRODUCTS. Questo filtro consente di recuperare gli account in grado di caricare i 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 ulteriori informazioni, consulta la guida al filtraggio.

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

Settimana del 19 maggio 2025

• È stata aggiornata la documentazione dell'API del programma, rimuovendo l'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 della risorsa OmnichannelSettingsService e OmnichannelSetting che consente agli utenti dell'API di gestire la propria esperienza omnicanale.
• Lancio della risorsa LfpProvidersService e LfpProvider che consente agli utenti dell'API di gestire la propria relazione di partnership con i feed locali.
• Lancio della risorsa GbpAccountsService e GbpAccount che consente agli utenti dell'API di gestire il proprio profilo dell'attività su Google.
• Lancio del 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 TermsOfServiceAgremeentState accettato racchiuso in un tipo di risposta.

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

• È stato chiarito che AccountsService.ListSubAccounts deve essere chiamato utilizzando il accounts/... formato (anziché providers/...). In questo modo si evita che questo metodo esca dall'ambito accounts (ovvero GET accounts/123:listSubAccounts anziché GET providers/123:listSubAccounts).

Settimana del 31 marzo 2025

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

• Nella documentazione di AccountsService è stato chiarito che non è possibile creare account autonomi.

Settimana del 3 marzo 2025

-The accounts.onlineReturnPolicies#SeasonalOverride è stato sottoposto a refactoring 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 policy deprecato è stato rimosso.

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

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

• Aggiornamenti degli articoli
• Miglioramenti delle immagini
• Miglioramenti della spedizione

Per ulteriori informazioni, consulta Attivare i miglioramenti automatici.

Settimana del 17 febbraio 2025

È stato rimosso il predicato callerHasAccessToProviderFilter() dal filtro dell'account.

Settimana del 10 febbraio 2025

• È stata migliorata la documentazione del metodo AccountsService.List. Restituisce tutti gli account a cui l'utente ha accesso, non solo gli account autonomi.

• È stato aggiunto un termine predefinito di 10 minuti per tutti i metodi RPC.

• È stato aggiunto l'elenco dei nomi dei programmi disponibili a accounts.programs descrizione della risorsa.

• User.accessRights ora è REQUIRED, il che influisce sui metodi UserService.Create e AccountsService.CreateAndConfigure.

Settimana del 27 gennaio 2025

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

Settimana del 20 gennaio 2025

Il campo users di CreateAndConfigureAccountRequest è obsoleto a favore di un nuovo user. CreateUserRequest a cui si fa 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 il filtraggio degli account, il externalAccountId predicato viene spostato dal relationship livello al service livello. 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 è obsoleto 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ò essere anche 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 dell'account. Tuttavia, per la compatibilità con le versioni precedenti, è ancora possibile utilizzare anche i nomi degli account come accounts/123.

Il provider in ListSubAccountsRequest ora deve essere nel 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 come REQUIRED (da OPTIONAL) nella risorsa BusinessIdentity. Questa modifica riguarda solo il metodo di aggiornamento. Lo scopo è chiarire 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

È stata migliorata la documentazione di varie risorse della sotto-API Accounts, come User, Homepage, BusinessInfo e così via.

Settimana del 21 ottobre 2024

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

È stato aggiunto il link al Centro assistenza Google Business per i corrieri supportati alla documentazione esterna della risorsa ShippingSettings.

Settimana del 14 ottobre 2024

Contrassegna provider come REQUIRED in AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

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

È stato aggiunto il parametro overwrite 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

È stato 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 sotto-API Accounts.