Przenoszenie zarządzania kontem z Content API for Shopping

Z tego dokumentu dowiesz się, jak przejść z Content API w wersji 2.1 na Merchant Center API.

Omówienie zmian w interfejsie Merchant API w porównaniu z Content API w wersji 2.1

Interfejs Merchant API wprowadza znaczne ulepszenia w stosunku do Content API w wersji 2.1, aby zwiększyć użyteczność, spójność i elastyczność dla programistów i firm.

Szczegółowa struktura zasobów

Zasoby w Merchant API reprezentują pojedyncze pojęcia, takie jak account, businessDetails, user, homepage i program. Są one uporządkowane hierarchicznie, aby odzwierciedlać ich wzajemne relacje. Na przykład account jest zasobem nadrzędnym dla user.

Usługi dotyczące ujednoliconego konta

Wszystkie usługi konta (np. agregacja kont MCA i ich subkont lub między kontami i usługodawcami zewnętrznymi) są zarządzane za pomocą zintegrowanego zasobu accountService. Dostawcy usług mogą zarządzać relacjami za pomocą zasobu accountRelationship.

Uproszczona struktura adresów URL

Adresy URL używają teraz jednego identyfikatora konta (na przykład merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}) zamiast wielu identyfikatorów. Ścieżki URL odzwierciedlają szczegółową strukturę zasobu.

Inne usprawnienia

  • Ulepszony system zarządzania programami i użytkownikami: programy takie jak reklamy produktowe i bezpłatne informacje są konsolidowane w ramach jednego zasobu program. Zasób user zapewnia kompleksowe funkcje zarządzania z dokładnymi uprawnieniami dostępu.
  • Uporządkowane informacje o firmie i jej tożsamość: dostępne są specjalne materiały dotyczące businessInfo i businessIdentity. Obejmują one obsługę zgodności z przepisami za pomocą pól przeznaczonych na dane dotyczące poszczególnych regionów. Na przykład koreański numer rejestracyjny firmy.
  • Uproszczone przypisywanie strony głównej: dedykowany zasób homepage zarządza adresem URL strony głównej sklepu. Metody takie jak claim i unclaim obsługują zgłaszanie witryn bezpośrednio przez interfejs API.
  • Zgodność z wytycznymi Google API: interfejs Merchant API ma być zgodny z propozycjami Google dotyczącymi ulepszeń interfejsu API.

Migracja zarządzania kontem

Za pomocą zasobu accounts możesz utworzyć konto sprzedawcy i nim zarządzać. Więcej informacji znajdziesz w artykule Omówienie interfejsu Merchant Accounts API.

Na tej stronie opisaliśmy, jak przenieść zarządzanie kontem z interfejsu Content API do Merchant API.

Żądania

W przypadku interfejsu Merchant Accounts API używaj tego formatu adresu URL żądania:

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

Oto przykładowe porównanie interfejsu Content API for Shopping z interfejsem Merchant Accounts API do tworzenia i zarządzania kontami:

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

Zasoby

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

Poniższa tabela porównuje zasób Account w Content API for Shopping z zasobem Account w interfejsie Merchant Accounts API.

Content API for Shopping Merchant Accounts API
id name
name accountName
kind Niedostępne
websiteUrl pole uri w zasobie Homepage.
adultContent adultContent
sellerId pole accountIdAlias w zasobie AccountRelationship.
users W zasobie User
youtubeChannelLinks Jeszcze niedostępny
googleMyBusinessLink Jeszcze niedostępny
businessInformation W zasobie businessInfo
businessIdentity W zasobie businessIdentity
automaticImprovements Jeszcze niedostępny
adsLinks pole campaignsManagement w zasobie AccountService.
cssId Dostępne tylko w interfejsie CSS API
labelIds Dostępne tylko w interfejsie CSS API
accountManagement pole accountManagement w zasobie AccountService.
automaticLabelIds Dostępne tylko w interfejsie CSS API
conversionSettings Jeszcze niedostępny

Poniższa tabela porównuje zasób AccountUser w Content API for Shopping z zasobem User w Merchant Accounts API.

Content API for Shopping Merchant Accounts API
emailAddress e-mail jest częścią name(accounts/{account}/users/{email}).
admin user#accessRights.ADMIN
orderManager Niedostępne
paymentsManager Niedostępna
paymentsAnalyst Niedostępne
reportingManager user#accessRights.PERFORMANCE_REPORTING

Poniższa tabela porównuje zasób AccountBusinessInformation w Content API for Shopping z jego odpowiednikiem businessInfo w interfejsie Merchant Accounts API.

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

Poniższa tabela porównuje zasób AccountBusinessIdentity w Content API for Shopping i zasób businessIdentity w Merchant Accounts API.

Content API for Shopping Merchant Accounts API
blackOwned blackOwned
womenOwned womenOwned
veteranOwned veteranOwned
latinoOwned latinoOwned
smallBusiness smallBusiness
includeForPromotions promotionsConsent
– true oznacza PROMOTION_CONSENT_GIVEN
– false oznacza PROMOTION_CONSENT_DENIED

Zasób AccountIdentityType w Content API jest reprezentowany przez typ IdentityAttribute i jego pole identityDeclaration w MerchantAPI.

Content API for Shopping Merchant Accounts API
self_identified identityDeclaration
– true oznacza SELF_IDENTIFIES_AS
– false oznacza DOES_NOT_SELF_IDENTIFY_AS

Metody

W interfejsie API kont sprzedawcy zostały wprowadzone następujące metody:

Content API for Shopping Merchant Accounts API
accounts.authinfo GET https://merchantapi.googleapis.com/accounts/v1beta/accounts bez filtra
accounts.claimwebsite POST https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/homepage:claim Więcej informacji znajdziesz w metodzie accounts.v1beta.accounts.homepage.claim
accounts.custombatch Niedostępne. W Merchant API nie można używać niestandardowych partii.
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 Więcej informacji znajdziesz w artykule Tworzenie i konfigurowanie konta sprzedawcy.
accounts.link AccountService zasób
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 Nieobsługiwane.
accounts.update Przekształca żądanie aktualizacji zasobu, w którym zdefiniowano wymagane pole lub zestaw pól.
accounts.updatelabels Dostępne tylko w interfejsie CSS API
accounts.verifyphonenumber Nieobsługiwane.
Wstecz
Przegląd
Dalej
Przenieś zarządzanie asortymentem