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 in base alle 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à strutturate e identità dell'attività: 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 homepage dedicata gestisce l'URL della home page del negozio. 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:

POST 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/accounts/accountId
Identificatori	merchantId/accounts/accountId	accounts/accountId

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](/merchant/api/reference/rest/v1/accounts.v1beta.accounts.users)
youtubeChannelLinks	Non ancora disponibile
googleMyBusinessLink	Non ancora disponibile
businessInformation	Nella risorsa [businessInfo](/merchant/api/reference/rest/v1/BusinessInfo)
businessIdentity	Nella risorsa [businessIdentity](/merchant/api/reference/rest/v1/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 fornisce 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	L'indirizzo 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
businessInformation	businessInfo
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/accounts/accountId/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/accounts/accountId
accounts.get	GET https://merchantapi.googleapis.com/accounts/v1beta/accountId`
accounts.insert	POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure
	Per saperne di più, vedi Creare e configurare un account commerciante
accounts.link	Risorsa AccountService
accounts.list	GET https://merchantapi.googleapis.com/accounts/v1beta/accountId:listSubaccounts
accounts.listlinks	GET https://merchantapi.googleapis.com/accounts/v1beta/accountId/services
accounts.update	Si mappa a una richiesta di aggiornamento per la risorsa in cui è definito il campo o l'insieme di campi obbligatori.