Eseguire la migrazione della gestione degli account dall'API Content for Shopping

Questo documento spiega come eseguire la migrazione dalla versione 2.1 dell'API Content all'API Merchant.

Panoramica delle modifiche dalla versione 2.1 dell'API Content all'API Merchant

L'API Merchant introduce miglioramenti significativi rispetto alla versione 2.1 dell'API Content, con l'obiettivo di migliorare l'usabilità, la coerenza e la flessibilità per sviluppatori e attività.

Struttura delle risorse granulari

Le risorse nell'API Merchant rappresentano singoli concetti, come account, businessDetails, user, homepage e program. Sono organizzati in modo gerarchico per riflettere le loro relazioni. Ad esempio, un account è la risorsa principale di un user.

Servizi account unificati

Tutti i servizi per gli account (ad esempio l'aggregazione degli account per gli AMC e i relativi subaccount o tra account e fornitori di servizi di terze parti) vengono gestiti tramite una risorsa accountService unificata. I fornitori di servizi possono gestire i propri rapporti utilizzando la risorsa accountRelationship.

Struttura di URL semplificata

Ora gli URL utilizzano un singolo ID account (ad es. merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}) anziché più ID. I percorsi degli URL rispecchiano la struttura granulare delle risorse.

Altri miglioramenti

• Gestione avanzata di programmi e utenti: i programmi come gli annunci Shopping e le schede senza costi sono raggruppati in un'unica risorsa program. La risorsa user include funzionalità di gestione complete con diritti di accesso granulari.
• Informazioni sull'attività e identità dell'attività strutturate: sono disponibili risorse dedicate per businessInfo e businessIdentity. Includono il supporto della conformità con campi per dati specifici per regione. Ad esempio, il numero di registrazione dell'attività in Corea.
• Rivendicazione della home page semplificata: una risorsa dedicata homepage gestisce l'URL della home page dello Store. Metodi come claim e unclaim gestiscono la rivendicazione del sito web direttamente tramite l'API.
• Conformità alle linee guida per le API di Google: l'API Merchant si propone di allinearsi alle proposte di miglioramento delle API di Google.

Migrazione della gestione dell'account

Puoi utilizzare la risorsa accounts per creare e gestire il tuo account commerciante. Per ulteriori informazioni, consulta la Panoramica dell'API Merchant Accounts.

Questa pagina descrive come eseguire la migrazione della gestione dell'account dall'API Content all'API Merchant.

Richieste

Utilizza il seguente formato dell'URL di richiesta per l'API Merchant Accounts:

https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts

Di seguito è riportato un confronto di esempio tra l'API Content for Shopping e l'API Merchant Accounts per le richieste di creazione e gestione dell'account:

	API Content per Shopping	API Merchant Accounts
URL	https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/	https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}
Identificatori	merchantId,accountId	``name

Risorse

I dati dell'account vengono trasmessi utilizzando la risorsa Account nell'API Content for Shopping. L'API Merchant Accounts fornisce più risorse per trasmettere i dati degli account. Queste risorse includono le risorse Account, User, BusinessInfo e BusinessIdentity.

La tabella seguente mostra un confronto tra la risorsa Account nell'API Content for Shopping e la risorsa Account nell'API Merchant Accounts.

API Content per Shopping	API Merchant Accounts
id	name
name	accountName
kind	Non disponibile
websiteUrl	Campo uri nella risorsa Homepage
adultContent	adultContent
sellerId	Campo accountIdAlias nella risorsa AccountRelationship
users	Nella risorsa User
youtubeChannelLinks	Non ancora disponibile
googleMyBusinessLink	Non ancora disponibile
businessInformation	Nella risorsa businessInfo
businessIdentity	Nella risorsa businessIdentity
automaticImprovements	Non ancora disponibile
adsLinks	Campo campaignsManagement nella risorsa AccountService
cssId	Disponibile solo nell'API CSS
labelIds	Disponibile solo nell'API CSS
accountManagement	Campo accountManagement nella risorsa AccountService
automaticLabelIds	Disponibile solo nell'API CSS
conversionSettings	Non ancora disponibile

La tabella seguente mostra un confronto tra la risorsa AccountUser nell'API Content for Shopping e la risorsa User nell'API Merchant Accounts.

API Content per Shopping	API Merchant Accounts
emailAddress	email fa parte del name (accounts/{account}/users/{email}).
admin	user#accessRights.ADMIN
orderManager	Non disponibile
paymentsManager	Non disponibile
paymentsAnalyst	Non disponibile
reportingManager	user#accessRights.PERFORMANCE_REPORTING

La tabella seguente mostra un confronto tra la risorsa AccountBusinessInformation nell'API Content for Shopping e la risorsa equivalente businessInfo nell'API Merchant Accounts.

API Content per Shopping	API Merchant Accounts
address	address
phoneNumber	phone
phoneVerificationStatus	phoneVerificationState
customerService	customerService
koreanBusinessRegistrationNumber	koreanBusinessRegistrationNumber

La tabella seguente mostra un confronto tra la risorsa AccountBusinessIdentity nell'API Content for Shopping e la risorsa businessIdentity nell'API Merchant Accounts.

API Content per Shopping	API Merchant Accounts
blackOwned	blackOwned
womenOwned	womenOwned
veteranOwned	veteranOwned
latinoOwned	latinoOwned
smallBusiness	smallBusiness
includeForPromotions	promotionsConsent
	- true indica PROMOTION_CONSENT_GIVEN
	- false indica PROMOTION_CONSENT_DENIED

La risorsa AccountIdentityType nell'API Content è rappresentata dal tipo IdentityAttribute e dal relativo campo identityDeclaration in MerchantAPI.

API Content per Shopping	API Merchant Accounts
self_identified	identityDeclaration
	- true indica SELF_IDENTIFIES_AS
	- false indica DOES_NOT_SELF_IDENTIFY_AS

Metodi

Nell'API Merchant Accounts sono stati introdotti i seguenti metodi:

API Content per Shopping	API Merchant Accounts
accounts.authinfo	GET https://merchantapi.googleapis.com/accounts/v1beta/accounts senza filtro
accounts.claimwebsite	POST https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/homepage:claim Per ulteriori informazioni, consulta Metodo: accounts.v1beta.accounts.homepage.claim
accounts.custombatch	Non disponibile. Il batch personalizzato non è supportato nell'API Merchant.
accounts.delete	DELETE https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}
accounts.get	GET https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}`
accounts.insert	POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure Per ulteriori informazioni, vedi Creare e configurare un account commerciante
accounts.link	Risorsa AccountService
accounts.list	GET https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}:listSubaccounts
accounts.listlinks	GET https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/services
accounts.requestphoneverification	Non supportati.
accounts.update	Si mappa a una richiesta di aggiornamento della risorsa in cui è definito il campo o l'insieme di campi obbligatori.
accounts.updatelabels	Disponibile solo nell'API CSS
accounts.verifyphonenumber	Non supportati.