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

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

In questa pagina viene descritto come eseguire la migrazione della gestione degli account dall'API Content all'API Merchant.

Richieste

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

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

Ecco un esempio di confronto tra l'API Content for Shopping e l'API Merchant per le richieste di creazione e gestione degli 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/{accountId}/accounts
Identificatori	{merchantId}/accounts/{accountId}	{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 seguente tabella offre 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	account_id
name	account_name
kind	Non disponibile
websiteUrl	Campo uri nella risorsa homepage
adultContent	adult_content
sellerId	Non disponibile
users	In User risorsa
youtubeChannelLinks	Non ancora disponibile
googleMyBusinessLink	Non ancora disponibile
businessInformation	In businessInfo risorsa
businessIdentity	In businessIdentity risorsa
automaticImprovements	Non ancora disponibile
adsLinks	Non ancora disponibile
cssId	Disponibile solo nell'API CSS
labelIds	Disponibile solo nell'API CSS
accountManagement	Non ancora disponibile
automaticLabelIds	Disponibile solo nell'API CSS
conversionSettings	Non ancora disponibile

La seguente tabella mette a confronto 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 di name (accounts/{account}/users/{email}).
admin	user#access_rights.ADMIN
orderManager	Non disponibile
paymentsManager	Non disponibile
paymentsAnalyst	Non disponibile
reportingManager	user#access_rights.PERFORMANCE_REPORTING

La seguente tabella offre 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	phone_verification_state
customerService	customer_service
koreanBusinessRegistrationNumber	Non disponibile

La seguente tabella offre 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	black_owned
womenOwned	women_owned
veteranOwned	veteran_owned
latinoOwned	latino_owned
smallBusiness	small_business
includeForPromotions	promotions_consent true significa PROMOTION_CONSENT_GIVEN false significa PROMOTION_CONSENT_DENIED

La seguente tabella offre un confronto tra la risorsa AccountIdentityType nell'API Content for Shopping e la risorsa identityAttribute nell'API Merchant Accounts.

API Content per Shopping	API Merchant Accounts
self_identified	identity_declaration true significa SELF_IDENTIFIES_AS false significa DOES_NOT_SELF_IDENTIFY_AS

Metodi

Nell'API Merchant Account 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, vedi 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	Viene mappato a una richiesta GET per la risorsa in cui è definito il campo obbligatorio o l'insieme di campi.
accounts.insert	POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure Per saperne di più, consulta l'articolo Creare e configurare un account commerciante.
accounts.link	Non ancora supportata
accounts.list	GET https://merchantapi.googleapis.com/accounts/v1beta/accountId:listSubaccounts
accounts.listlinks	Non ancora supportata
accounts.update	Viene mappato a una richiesta di aggiornamento della risorsa, in cui è definito il campo obbligatorio o l'insieme di campi.