Halaman ini diterjemahkan oleh Cloud Translation API.

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-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 resource 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:

POST 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/accounts/`accountId
Pengenal	merchantId`/accounts/`accountId	`accounts/`accountId

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](/merchant/api/reference/rest/v1/accounts.v1beta.accounts.users)`
`youtubeChannelLinks`	Belum tersedia
`googleMyBusinessLink`	Belum tersedia
`businessInformation`	Di resource `[businessInfo](/merchant/api/reference/rest/v1/BusinessInfo)`
`businessIdentity`	Di resource `[businessIdentity](/merchant/api/reference/rest/v1/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
`businessInformation`	`businessInfo`
`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/accounts/`accountId`/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/accounts/`accountId
`accounts.get`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`
`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/`accountId`:listSubaccounts`
`accounts.listlinks`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`/services`
`accounts.update`	Dipetakan ke permintaan pembaruan untuk resource tempat kolom atau kumpulan kolom yang diperlukan ditentukan.

Sebelumnya

Ringkasan

Berikutnya

Memigrasikan pengelolaan inventaris