Method: accounts.homepage.claim

Xác nhận quyền sở hữu trang chủ của cửa hàng. Bạn cần có quyền quản trị để thực thi phương thức này.

Nếu trang chủ đã được xác nhận quyền sở hữu, thì hệ thống sẽ kiểm tra lại quy trình xác minh (trừ phi người bán được miễn xác nhận quyền sở hữu, đồng thời được miễn xác minh) và trả về phản hồi thành công. Nếu không thể xác minh quyền sở hữu nữa, hệ thống sẽ trả về lỗi nhưng không xoá thông báo xác nhận quyền sở hữu. Trong trường hợp không thành công, hệ thống sẽ trả về một thông báo lỗi chuẩn: * PERMISSION_DENIED: người dùng không có các quyền cần thiết trên tài khoản MC này; * FAILED_PRECONDITION: – Tài khoản không phải là tài khoản Merchant Center; – Tài khoản MC không có trang chủ; – xác nhận quyền sở hữu không thành công (trong trường hợp này, thông báo lỗi sẽ chứa thêm thông tin chi tiết).

Yêu cầu HTTP

POST https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*/homepage}:claim

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

Bắt buộc. Tên của trang chủ cần xác nhận quyền sở hữu. Định dạng accounts/{account}/homepage

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "overwrite": boolean
}
Trường
overwrite

boolean

Không bắt buộc. Khi được đặt thành true, tuỳ chọn này sẽ xoá mọi thông báo xác nhận quyền sở hữu hiện có trên trang web được yêu cầu và thay thế bằng thông báo xác nhận quyền sở hữu của tài khoản gửi yêu cầu.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Homepage.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.