Note di rilascio dell'API Merchant Accounts

Settimana del 25 agosto 2025

  • Sono stati aggiunti nuovi metodi batch all'API Regions:
    • BatchCreateRegions: consente di creare più regioni in un'unica richiesta.
    • BatchUpdateRegions: consente di aggiornare più regioni in una singola 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 ti consente di recuperare gli account in grado di caricare prodotti. Ciò significa che ora le seguenti clausole possono essere utilizzate 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 diritto di accesso in 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 amministratore.

Settimana del 12 maggio 2025

  • Lancio della risorsa Norme per i resi online che consente agli utenti API di creare, aggiornare ed eliminare le norme per i 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 con 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.
    • Avvia il tipo di servizio LocalListingManagement in AccountService, che collega il gruppo aziendale 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 API di gestire le relazioni e stabilire servizi con i fornitori di servizi.

Settimana del 14 aprile 2025

  • TermsOfServiceService.AcceptTermsOfService ora restituisce il 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 formato accounts/... (anziché providers/...). In questo modo si evita che questo metodo esca dall'ambito di 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 annunciato come ritirato nella settimana del 2 dicembre 2024 e ora non è più disponibile. Ciò significa che il filtro 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")).

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

Settimana del 3 marzo 2025

- Il accounts.onlineReturnPolicies#SeasonalOverride è stato refattorizzato per migliorare la chiarezza e la coerenza. Questi aggiornamenti includono:

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

- Gli sviluppatori devono aggiornare il codice in modo che rifletta queste modifiche.

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

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

Settimana del 17 febbraio 2025

È stato 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.

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

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

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

Settimana del 27 gennaio 2025

AccountsService.ListAccounts (e transitivamente AccountsService.ListSubAccounts) ora restituiscono gli account in modo coerente nel tempo anziché essere una lettura coerente.

Settimana del 20 gennaio 2025

Il campo users di CreateAndConfigureAccountRequest è obsoleto 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 è compilato con merchantapi.googleapis.com anziché global

Settimana del 2 dicembre 2024

Per il filtraggio degli account, il predicato externalAccountId viene spostato al livello service dal livello relationship. 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 fornitore nel campo CreateAndConfigureAccountRequest.service.provider ora può essere anche 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 a un account. Tuttavia, è ancora possibile utilizzare nomi 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à ancora possibile utilizzare accounts/123.

Settimana del 4 novembre 2024

Contrassegna promotions_consent REQUIRED (dal giorno OPTIONAL) nella risorsa BusinessIdentity. Questo riguarda solo il metodo di aggiornamento. per 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

Miglioramento della documentazione di varie risorse della sub-API Accounts, ad esempio User, Homepage, BusinessInfo e così via.

Settimana del 21 ottobre 2024

Migliora 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 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 sotto-API Accounts (ad es. identità dell'attività, informazioni sull'attività, home page e così via) e retroattivamente per la risorsa ConversionSources.

Aggiunta del 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

Modificato il tipo di parametro time_zone in stringa in ListAccountIssuesRequest

Settimana del 12 agosto 2024

Aggiunto il campo korean_business_registration_number alla risorsa BusinessInfo.

Settimana del 27 maggio 2024

Lancio della beta della sub-API Accounts