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 przenieść zarządzanie kontem z Content API for Shopping do Merchant 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 koncepcje, takie jak:

account

account jest zasobem nadrzędnym dla pozostałych zasobów.

Usługi dotyczące ujednoliconego konta

Wszystkie usługi dotyczące kont (np. agregacja kont MCA i ich podkont lub między kontami i dostawcami usług innych firm) 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 sposób 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 obejmuje 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 umożliwiają bezpośrednie zgłaszanie witryny za pomocą interfejsu 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/accounts/{ACCOUNT_ID}

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

	Content API.	Merchant API
URL	`https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accounts/{ACCOUNT_ID}`	`https://merchantapi.googleapis.com/accounts/v1beta/{NAME}`
Identyfikatory	`{MERCHANT_ID}`, `{ACCOUNT_ID}`	`{NAME}` będzie mieć format: `accounts/{ACCOUNT_ID}`

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 zawiera porównanie zasobu 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ępne
`googleMyBusinessLink`	Jeszcze niedostępne
`businessInformation`	W zasobie `businessInfo`
`businessIdentity`	W zasobie `businessIdentity`
`automaticImprovements`	Jeszcze niedostępne
`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ępne

Poniższa tabela porównuje zasób AccountUser w Content API for Shopping z zasobem User w interfejsie 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 zawiera porównanie zasobu AccountBusinessIdentity w Content API for Shopping i zasobu 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`

Zasoby AccountIdentityType w Content API są reprezentowane przez typ IdentityAttribute i jego pole IdentityDeclaration w Merchant API.

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 Merchant Accounts API 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 interfejsie 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/} Metoda accounts.get nie obsługuje parametru view**.
`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` Jeśli jesteś użytkownikiem usługi porównywania cen, możesz użyć metody ListChildAccounts, aby wyświetlić listę wszystkich kont powiązanych z konkretnym kontem usługi porównywania cen.
`accounts.listlinks`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`*{parent=accounts/}**`/services`
`accounts.requestphoneverification`	Interfejs Merchant API nie obsługuje metody weryfikacji przez telefon.
`accounts.update`	Zasób Accounts.patch
`accounts.updatelabels`	Dostępne tylko w interfejsie CSS API
`accounts.verifyphonenumber`	Nieobsługiwane.

Wstecz

Overview

Dalej

Migrate homepage management

Przenoszenie zarządzania kontem z Content API for Shopping Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.