Ta strona została przetłumaczona przez Cloud Translation API.

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, które mają na celu zwiększenie użyteczności, spójności i elastyczności 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/{ACCOUNT_ID}/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