Przenoszenie zarządzania kontem z Content API for Shopping

Możesz skorzystać z materiałów dotyczących kont, aby utworzyć konto sprzedawcy i nim zarządzać. Więcej informacji znajdziesz w artykule Omówienie interfejsu Merchant Account API.

Na tej stronie dowiesz się, jak przenieść zarządzanie kontem z Content API do Merchant API.

Żądania

Użyj tego formatu adresu URL żądania w przypadku interfejsu API kont sprzedawców:

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

Oto przykładowe porównanie interfejsów Content API for Shopping z interfejsem MerchantAccounts API w zakresie tworzenia kont i zarządzania nimi:

Content API for Shopping Interfejs API kont sprzedawców
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/ https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts
Identyfikatory {merchantId}/accounts/{accountId} {accountId}

Zasoby

Dane konta są przekazywane za pomocą zasobu Account w Content API for Shopping. Merchant Account API zapewnia wiele zasobów do przekazywania danych kont. Te zasoby obejmują zasoby Account, User, BusinessInfo i BusinessIdentity.

W tabeli poniżej znajdziesz porównanie zasobu Account w Content API for Shopping z zasobem Account w interfejsie MerchantAccounts API.

Content API for Shopping Interfejs API kont sprzedawców
id account_id
name account_name
kind Niedostępna
websiteUrl Pole uri w zasobie homepage
adultContent adult_content
sellerId Niedostępna
users W User zasobie
youtubeChannelLinks Jeszcze niedostępny
googleMyBusinessLink Jeszcze niedostępny
businessInformation W businessInfo zasobie
businessIdentity W businessIdentity zasobie
automaticImprovements Jeszcze niedostępny
adsLinks Jeszcze niedostępny
cssId Dostępne tylko w interfejsie CSS API
labelIds Dostępne tylko w interfejsie CSS API
accountManagement Jeszcze niedostępny
automaticLabelIds Dostępne tylko w interfejsie CSS API
conversionSettings Jeszcze niedostępny

W tabeli poniżej znajdziesz porównanie zasobu AccountUser w Content API for Shopping z zasobem User w interfejsie Merchant Accounts API.

Content API for Shopping Interfejs API kont sprzedawców
emailAddress email jest częścią name
(accounts/{account}/users/{email}).
admin user#access_rights.ADMIN
orderManager Niedostępna
paymentsManager Niedostępna
paymentsAnalyst Niedostępna
reportingManager user#access_rights.PERFORMANCE_REPORTING

W tabeli poniżej znajdziesz porównanie zasobu AccountBusinessInformation w Content API for Shopping i odpowiadającego mu zasobu businessinfo w interfejsie Merchant Accounts API.

Content API for Shopping Interfejs API kont sprzedawców
businessInformation businessinfo
phoneNumber phone
phoneVerificationStatus phone_verification_state
customerService customer_service
koreanBusinessRegistrationNumber Niedostępna

W tabeli poniżej znajdziesz porównanie zasobu AccountBusinessIdentity w Content API for Shopping i zasobu businessIdentity w interfejsie Merchant Accounts API.

Content API for Shopping Interfejs API kont sprzedawców
blackOwned black_owned
womenOwned women_owned
veteranOwned veteran_owned
latinoOwned latino_owned
smallBusiness small_business
includeForPromotions promotions_consent
true oznacza PROMOTION_CONSENT_GIVEN
false oznacza PROMOTION_CONSENT_DENIED

W tabeli poniżej znajdziesz porównanie zasobu AccountIdentityType w Content API for Shopping z zasobem identityAttribute w interfejsie Merchant Accounts API.

Content API for Shopping Interfejs API kont sprzedawców
self_identified identity_declaration
true oznacza SELF_IDENTIFIES_AS
false oznacza DOES_NOT_SELF_IDENTIFY_AS

Metody

W interfejsie API kont sprzedawców wprowadziliśmy te metody:

Content API for Shopping Interfejs API kont sprzedawców
accounts.authinfo GET https://merchantapi.googleapis.com/accounts/v1beta/accounts bez filtra
accounts.claimwebsite POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId/homepage:claim
Więcej informacji znajdziesz w artykule Metoda: accounts.v1beta.accounts.homepage.claim.
accounts.custombatch Niedostępne. Niestandardowa wsad nie jest obsługiwana w interfejsie Merchant API.
accounts.delete DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/accountId
accounts.get Odpowiada to żądanie GET dotyczące zasobu, w którym zdefiniowano wymagane pole lub zbiór pól.
accounts.insert POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure
Więcej informacji znajdziesz w artykule Tworzenie i konfigurowanie konta sprzedawcy.
accounts.link Jeszcze nieobsługiwana
accounts.list GET https://merchantapi.googleapis.com/accounts/v1beta/accountId:listSubaccounts
accounts.listlinks Jeszcze nieobsługiwana
accounts.update Odpowiada to żądanie aktualizacji zasobu, w którym zdefiniowano wymagane pole lub zbiór pól.