Trang này được dịch bởi Cloud Translation API.

Di chuyển hoạt động quản lý tài khoản từ Content API for Shopping

Tài liệu này giải thích cách di chuyển từ Content API phiên bản 2.1 sang Merchant API.

Tổng quan về các thay đổi từ Content API phiên bản 2.1 sang Merchant API

Merchant API mang đến những điểm cải tiến đáng kể so với Content API phiên bản 2.1, nhằm mục đích nâng cao khả năng hữu dụng, tính nhất quán và tính linh hoạt cho nhà phát triển và doanh nghiệp.

Cấu trúc tài nguyên chi tiết

Tài nguyên trong Merchant API đại diện cho các khái niệm đơn lẻ, chẳng hạn như account, businessDetails, user, homepage và program. Các thành phần này được sắp xếp theo hệ phân cấp để phản ánh mối quan hệ giữa chúng. Ví dụ: account là tài nguyên mẹ của user.

Dịch vụ tài khoản hợp nhất

Tất cả dịch vụ tài khoản (ví dụ: tổng hợp tài khoản cho MCA và tài khoản phụ của chúng hoặc giữa nhà cung cấp dịch vụ bên thứ ba và tài khoản) đều được quản lý thông qua tài nguyên accountService hợp nhất. Nhà cung cấp dịch vụ có thể quản lý mối quan hệ của họ bằng cách sử dụng tài nguyên accountRelationship.

Cấu trúc URL đơn giản

URL hiện sử dụng một mã tài khoản duy nhất (ví dụ: merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}) thay vì nhiều mã. Đường dẫn URL phản ánh cấu trúc tài nguyên chi tiết.

Cải tiến khác

Cải tiến tính năng quản lý người dùng và chương trình: Các chương trình như Quảng cáo Mua sắm và Trang thông tin miễn phí được hợp nhất trong một tài nguyên program. Tài nguyên user bao gồm các chức năng quản lý toàn diện với quyền truy cập chi tiết.
Thông tin doanh nghiệp có cấu trúc và thông tin nhận dạng doanh nghiệp: Có các tài nguyên chuyên biệt dành cho businessInfo và businessIdentity. Các mẫu này hỗ trợ tuân thủ bằng các trường dành cho dữ liệu theo khu vực. Ví dụ: số đăng ký kinh doanh tại Hàn Quốc.
Cách đơn giản để xác nhận quyền sở hữu trang chủ: Một tài nguyên homepage chuyên dụng sẽ quản lý URL trang chủ của cửa hàng. Các phương thức như claim và unclaim xử lý việc xác nhận quyền sở hữu trang web trực tiếp thông qua API.
Tuân thủ nguyên tắc của Google về API: Merchant API hướng đến việc điều chỉnh cho phù hợp với các đề xuất cải tiến API của Google.

Di chuyển quyền quản lý tài khoản

Bạn có thể sử dụng tài nguyên accounts để tạo và quản lý tài khoản người bán. Để biết thêm thông tin, hãy xem bài viết Tổng quan về API Tài khoản người bán.

Trang này mô tả cách di chuyển hoạt động quản lý tài khoản từ Content API sang Merchant API.

Yêu cầu

Sử dụng định dạng URL yêu cầu sau đây cho Merchant Accounts API:

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

Dưới đây là bảng so sánh mẫu giữa Content API for Shopping với Merchant Accounts API cho các yêu cầu tạo và quản lý tài khoản:

	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
Giá trị nhận dạng	merchantId`/accounts/`accountId	`accounts/`accountId

Tài nguyên

Dữ liệu tài khoản được truyền bằng tài nguyên Account trong Content API for Shopping. API Tài khoản người bán cung cấp nhiều tài nguyên để truyền dữ liệu tài khoản. Các tài nguyên này bao gồm tài nguyên Account, User, BusinessInfo và BusinessIdentity.

Bảng sau đây so sánh giữa tài nguyên Account trong Content API for Shopping và tài nguyên Account trong Merchant Accounts API.

Content API for Shopping	Merchant Accounts API
`id`	`name`
`name`	`accountName`
`kind`	Không có
`websiteUrl`	Trường `uri` trong tài nguyên `Homepage`
`adultContent`	`adultContent`
`sellerId`	Trường `accountIdAlias` trong tài nguyên `AccountRelationship`
`users`	Trong tài nguyên `[User](/merchant/api/reference/rest/v1/accounts.v1beta.accounts.users)`
`youtubeChannelLinks`	Chưa có
`googleMyBusinessLink`	Chưa có
`businessInformation`	Trong tài nguyên `[businessInfo](/merchant/api/reference/rest/v1/BusinessInfo)`
`businessIdentity`	Trong tài nguyên `[businessIdentity](/merchant/api/reference/rest/v1/BusinessIdentity)`
`automaticImprovements`	Chưa có
`adsLinks`	Trường `campaignsManagement` trong tài nguyên `AccountService`
`cssId`	Chỉ có trong API CSS
`labelIds`	Chỉ có trong API CSS
`accountManagement`	Trường `accountManagement` trong tài nguyên `AccountService`
`automaticLabelIds`	Chỉ có trong API CSS
`conversionSettings`	Chưa có

Bảng sau đây so sánh tài nguyên AccountUser trong Content API for Shopping với tài nguyên User trong Merchant Accounts API.

Content API for Shopping	Merchant Accounts API
`emailAddress`	email là một phần của `name`(`accounts/{account}/users/{email}`).
`admin`	`user#accessRights.ADMIN`
`orderManager`	Không có
`paymentsManager`	Không có sẵn
`paymentsAnalyst`	Không có
`reportingManager`	`user#accessRights.PERFORMANCE_REPORTING`

Bảng sau đây so sánh tài nguyên AccountBusinessInformation trong Content API for Shopping với tài nguyên tương đương businessInfo trong Merchant Accounts API.

Content API for Shopping	Merchant Accounts API
`businessInformation`	`businessInfo`
`phoneNumber`	`phone`
`phoneVerificationStatus`	`phoneVerificationState`
`customerService`	`customerService`
`koreanBusinessRegistrationNumber`	`koreanBusinessRegistrationNumber`

Bảng sau đây so sánh tài nguyên AccountBusinessIdentity trong Content API for Shopping với tài nguyên businessIdentity trong Merchant Accounts API.

Content API for Shopping	Merchant Accounts API
`blackOwned`	`blackOwned`
`womenOwned`	`womenOwned`
`veteranOwned`	`veteranOwned`
`latinoOwned`	`latinoOwned`
`smallBusiness`	`smallBusiness`
`includeForPromotions`	`promotionsConsent`
	– `true` biểu thị `PROMOTION_CONSENT_GIVEN`
	– `false` biểu thị `PROMOTION_CONSENT_DENIED`

Tài nguyên AccountIdentityType trong Content API được biểu thị bằng loại IdentityAttribute và trường identityDeclaration trong MerchantAPI.

Content API for Shopping	Merchant Accounts API
`self_identified`	`identityDeclaration`
	– `true` biểu thị `SELF_IDENTIFIES_AS`
	– `false` biểu thị `DOES_NOT_SELF_IDENTIFY_AS`

Phương thức

Các phương thức sau đây đã được giới thiệu trong Merchant Accounts API:

Content API for Shopping	Merchant Accounts API
`accounts.authinfo`	`GET https://merchantapi.googleapis.com/accounts/v1beta/accounts` không có bộ lọc
`accounts.claimwebsite`	`POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/`accountId`/homepage:claim`
	Để biết thêm thông tin, hãy xem Phương thức: accounts.v1beta.accounts.homepage.claim
`accounts.custombatch`	Không có. Merchant API không hỗ trợ lô tuỳ chỉnh.
`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`
	Để biết thêm thông tin, hãy xem bài viết Tạo và định cấu hình tài khoản người bán
`accounts.link`	Tài nguyên `AccountService`
`accounts.list`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`:listSubaccounts`
`accounts.listlinks`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`/services`
`accounts.update`	Liên kết đến một yêu cầu cập nhật cho tài nguyên mà trường hoặc tập hợp trường bắt buộc được xác định.

Tổng quan

Tiếp

Di chuyển hoạt động quản lý khoảng không quảng cáo