Memigrasikan pengelolaan akun dari Content API for Shopping

Dokumen ini menjelaskan cara memigrasikan dari Content API v2.1 ke Merchant API.

Ringkasan perubahan dari Content API v2.1 ke Merchant API

Merchant API memperkenalkan peningkatan yang signifikan dibandingkan Content API v2.1, yang bertujuan untuk meningkatkan kegunaan, konsistensi, dan fleksibilitas bagi developer dan bisnis.

Struktur resource terperinci

Resource di Merchant API mewakili satu konsep, seperti account, businessDetails, user, homepage, dan program. Elemen tersebut diatur secara hierarkis untuk mencerminkan hubungannya. Misalnya, account adalah resource induk untuk user.

Layanan akun terpadu

Semua layanan akun (misalnya, agregasi akun untuk MCA dan sub-akunnya atau antara penyedia layanan pihak ketiga dan akun) dikelola melalui resource accountService terpadu. Penyedia layanan dapat mengelola hubungan mereka menggunakan resource accountRelationship.

Struktur URL yang disederhanakan

URL kini menggunakan satu ID akun (misalnya, merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}), bukan beberapa ID. Jalur URL mencerminkan struktur resource terperinci.

Peningkatan lainnya

• Pengelolaan program dan pengguna yang ditingkatkan: Program seperti Iklan Shopping dan Listingan Gratis digabungkan dalam satu resource program. Resource user mencakup kemampuan pengelolaan yang komprehensif dengan hak akses terperinci.
• Informasi bisnis terstruktur dan identitas bisnis: Ada referensi khusus untuk businessInfo dan businessIdentity. Fitur ini mencakup dukungan kepatuhan dengan kolom untuk data khusus region. Misalnya, nomor pendaftaran bisnis Korea.
• Proses klaim halaman beranda yang disederhanakan: Resource homepage khusus mengelola URL halaman beranda Play Store. Metode seperti claim dan unclaim menangani klaim situs secara langsung melalui API.
• Kepatuhan terhadap pedoman Google API: Merchant API bertujuan untuk selaras dengan proposal peningkatan API Google.

Migrasi pengelolaan akun

Anda dapat menggunakan resource accounts untuk membuat dan mengelola akun penjual. Untuk informasi selengkapnya, lihat Ringkasan Merchant Accounts API.

Halaman ini menjelaskan cara memigrasikan pengelolaan akun dari Content API ke Merchant API.

Permintaan

Gunakan format URL permintaan berikut untuk Merchant Accounts API:

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

Berikut adalah contoh perbandingan Content API for Shopping dengan Merchant Accounts API untuk permintaan pembuatan dan pengelolaan akun:

	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/*}
Pengenal	merchantId,accountId	``name

Resource

Data akun diteruskan menggunakan resource Account di Content API for Shopping. Merchant Accounts API menyediakan beberapa resource untuk meneruskan data akun. Resource ini mencakup resource Account, User, BusinessInfo, dan BusinessIdentity.

Tabel berikut memberikan perbandingan antara resource Account di Content API for Shopping dan resource Account di Merchant Accounts API.

Content API for Shopping	Merchant Accounts API
id	name
name	accountName
kind	Tidak tersedia
websiteUrl	Kolom uri di resource Homepage
adultContent	adultContent
sellerId	Kolom accountIdAlias di resource AccountRelationship
users	Di resource User
youtubeChannelLinks	Belum tersedia
googleMyBusinessLink	Belum tersedia
businessInformation	Di resource businessInfo
businessIdentity	Di resource businessIdentity
automaticImprovements	Belum tersedia
adsLinks	Kolom campaignsManagement di resource AccountService
cssId	Hanya tersedia di CSS API
labelIds	Hanya tersedia di CSS API
accountManagement	Kolom accountManagement di resource AccountService
automaticLabelIds	Hanya tersedia di CSS API
conversionSettings	Belum tersedia

Tabel berikut memberikan perbandingan antara resource AccountUser di Content API for Shopping dan resource User di Merchant Accounts API.

Content API for Shopping	Merchant Accounts API
emailAddress	email adalah bagian dari name (accounts/{account}/users/{email}).
admin	user#accessRights.ADMIN
orderManager	Tidak tersedia
paymentsManager	Tidak tersedia
paymentsAnalyst	Tidak tersedia
reportingManager	user#accessRights.PERFORMANCE_REPORTING

Tabel berikut memberikan perbandingan antara resource AccountBusinessInformation di Content API for Shopping dan resource yang setara businessInfo di Merchant Accounts API.

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

Tabel berikut memberikan perbandingan antara resource AccountBusinessIdentity di Content API for Shopping dan resource businessIdentity di Merchant Accounts API.

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

Resource AccountIdentityType di Content API diwakili oleh jenis IdentityAttribute dan kolomnya identityDeclaration di MerchantAPI.

Content API for Shopping	Merchant Accounts API
self_identified	identityDeclaration
	- true menunjukkan SELF_IDENTIFIES_AS
	- false menunjukkan DOES_NOT_SELF_IDENTIFY_AS

Metode

Metode berikut telah diperkenalkan di Merchant Accounts API:

Content API for Shopping	Merchant Accounts API
accounts.authinfo	GET https://merchantapi.googleapis.com/accounts/v1beta/accounts tanpa filter
accounts.claimwebsite	POST https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/homepage:claim Untuk mengetahui informasi selengkapnya, lihat Metode: accounts.v1beta.accounts.homepage.claim
accounts.custombatch	Tidak tersedia. Batch kustom tidak didukung di Merchant API.
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 Untuk informasi selengkapnya, lihat Membuat dan mengonfigurasi akun penjual
accounts.link	AccountService resource
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	Tidak didukung.
accounts.update	Dipetakan ke permintaan pembaruan untuk resource tempat kolom atau kumpulan kolom yang diperlukan ditentukan.
accounts.updatelabels	Hanya tersedia di CSS API
accounts.verifyphonenumber	Tidak didukung.