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

Trạng thái tài khoản

Bạn có thể sử dụng accountstatuses để xem trạng thái của tài khoản người bán Tài khoản Center hoặc MCA (tài khoản nhiều khách hàng) và tất cả các tài khoản phụ được liên kết với nó.

Những người bán có nhiều cửa hàng trực tuyến hoặc thương hiệu bán riêng các trang web có thể chọn có tài khoản phụ trong MCA.

Người bán có trách nhiệm tuân thủ Chính sách mua sắm quảng cáo và miễn phí trang thông tin. Điều khoản Google Mua sắm giữ quyền thực thi những chính sách này và phản hồi một cách thích hợp nếu chúng tôi phát hiện nội dung hoặc hành vi vi phạm các chính sách này.

Xem tài liệu tham khảo Vấn đề về tài khoản để biết thông tin chi tiết về các vấn đề thường gặp liên quan đến tài khoản.

accountstatuses.get

Bạn có thể sử dụng accountstatuses.get để xem thông tin trạng thái tài khoản cho tài khoản người bán duy nhất.

Bạn có thể sử dụng thông số destination để kiểm soát các vấn đề về sản phẩm bị trả về. Khi không chỉ định đích đến, phản hồi mặc định sẽ bao gồm trạng thái của destination: Shopping.

Sau đây là một yêu cầu mẫu, trong đó merchantId là mã tài khoản nhiều khách hàng (MCA) và accountId là một tài khoản phụ của MCA đó:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId

Để nhận thông tin về trạng thái tài khoản cho tài khoản độc lập, hãy gọi accountstatuses.get có cùng mã tài khoản cho merchantId và accountId.

Phương thức này trả về các vấn đề ở cấp tài khoản và mặt hàng. Bạn có thể sử dụng trang Mua sắm quảng cáo và Miễn phí trang thông tin cần khắc phục accountLevelIssues đã trả lời trong phản hồi của accountstatuses.get.

Dưới đây là phản hồi mẫu cho một tài khoản phụ đã bị tạm ngưng do một yêu cầu "đích trang không hoạt động" vi phạm chính sách.

{
 "kind": "content#accountStatus",
 "accountId": "123456789",
 "websiteClaimed": true,
 "accountLevelIssues": [
  {
   "id": "editorial_and_professional_standards_destination_url_down_policy",
   "title": "Account suspended due to policy violation: landing page not working",
   "country": "US",
   "severity": "critical",
   "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
  },
  {
   "id": "missing_ad_words_link",
   "title": "No Google Ads account linked",
   "severity": "error",
   "documentation": "https://support.google.com/merchants/answer/6159060"
  }
 ],
 "products": [
  {
   "channel": "online",
   "destination": "Shopping",
   "country": "US",
   "statistics": {
    "active": "0",
    "pending": "0",
    "disapproved": "5",
    "expiring": "0"
   },
   "itemLevelIssues": [
    {
     "code": "image_link_broken",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "image link",
     "description": "Invalid image [image link]",
     "detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
     "documentation": "https://support.google.com/merchants/answer/6098289",
     "numItems": "2"
    },
    {
     "code": "landing_page_error",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "link",
     "description": "Unavailable desktop landing page",
     "detail": "Update your website or landing page URL to enable access from desktop devices",
     "documentation": "https://support.google.com/merchants/answer/6098155",
     "numItems": "5"
    },
    {
     "code": "missing_condition_microdata",
     "servability": "unaffected",
     "resolution": "merchant_action",
     "description": "Missing or invalid data [condition]",
     "detail": "Add valid structured data markup to your landing page",
     "documentation": "https://support.google.com/merchants/answer/6183460",
     "numItems": "5"
    },
    {
     "code": "mobile_landing_page_error",
     "servability": "disapproved",
     "resolution": "merchant_action",
     "attributeName": "link",
     "description": "Unavailable mobile landing page",
     "detail": "Update your website or landing page URL to enable access from mobile devices",
     "documentation": "https://support.google.com/merchants/answer/6098296",
     "numItems": "3"
    }
   ]
  }
 ]
}

accountstatuses.list

Bạn có thể sử dụng accountstatuses.list để xem thông tin trạng thái tài khoản trên tất cả tài khoản phụ của MCA.

Bạn có thể sử dụng bộ lọc với accountstatuses.list để lọc các vấn đề về sản phẩm theo đích. Khi bạn không chỉ định một đích đến, phản hồi sẽ bao gồm các trạng thái với giá destination: Shopping.

Dưới đây là yêu cầu mẫu để lấy thông tin trạng thái tài khoản cho tất cả các tài khoản phụ trong MCA merchantId:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses

Dưới đây là phản hồi mẫu:

{
 "kind": "content#accountstatusesListResponse",
 "resources": [
  {
   "kind": "content#accountStatus",
   "accountId": "1234567",
   "websiteClaimed": true,
   "accountLevelIssues": [
    {
     "id": "editorial_and_professional_standards_destination_url_down_policy",
     "title": "Account suspended due to policy violation: landing page not working",
     "country": "US",
     "severity": "critical",
     "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
    },
    {
     "id": "missing_ad_words_link",
     "title": "No Google Ads account linked",
     "severity": "error",
     "documentation": "https://support.google.com/merchants/answer/6159060"
    }
   ],
   "products": [
    {
     "channel": "online",
     "destination": "Shopping",
     "country": "US",
     "statistics": {
      "active": "0",
      "pending": "0",
      "disapproved": "0",
      "expiring": "0"
     }
    }
   ]
  },
  {
   "kind": "content#accountStatus",
   "accountId": "123456789",
   "websiteClaimed": true,
   "accountLevelIssues": [
    {
     "id": "home_page_issue",
     "title": "Website URL not provided",
     "severity": "critical",
     "documentation": "https://support.google.com/merchants/answer/176793"
    },
    {
     "id": "missing_ad_words_link",
     "title": "No Google Ads account linked",
     "severity": "error",
     "documentation": "https://support.google.com/merchants/answer/6159060"
    }
   ],
   "products": [
    {
     "channel": "online",
     "destination": "Shopping",
     "country": "US",
     "statistics": {
      "active": "0",
      "pending": "0",
      "disapproved": "0",
      "expiring": "0"
     }
    }
   ]
  }
 ]
}

Lệnh gọi đến accountstatuses.list cho tài khoản không phải tài khoản nhiều khách hàng (ví dụ: tài khoản Merchant Center độc lập) trả về lỗi 403.

Dưới đây là phản hồi mẫu về việc gọi accountstatuses.list cho một chức năng độc lập tài khoản:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "forbidden",
    "message": "111111111 is not a multi-client account (MCA). The only account
                service operations allowed on non-MCAs are 'get', 'update',
                'authinfo' and 'claimwebsite'."
   }
  ],
  "code": 403,
  "message": "111111111 is not a multi-client account (MCA). The only account
              service operations allowed on non-MCAs are 'get', 'update',
              'authinfo' and 'claimwebsite'."
 }
}

Chế độ lô

accountstatuses.custombatch với phương thức GET trả về tài khoản thông tin trạng thái của nhiều tài khoản phụ trong tài khoản nhiều khách hàng.

JSON yêu cầu bao gồm merchantId của số tài khoản MCA, accountId của tài khoản phụ, một batchId duy nhất và method được đặt thành get.

POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch

Sau đây là nội dung yêu cầu JSON mẫu:

{
  "entries": [
    {
      "accountId": 1212121212,
      "merchantId": 4444444444,
      "method": "get",
      "batchId": 9
    },
    {
      "accountId": 1313131313,
      "merchantId": 4444444444,
      "method": "get",
      "batchId": 99
    }
  ]
}

Sau đây là nội dung phản hồi JSON mẫu:

{
 "kind": "content#accountstatusesCustomBatchResponse",
 "entries": [
  {
   "batchId": 9,
   "accountStatus": {
    "kind": "content#accountStatus",
    "accountId": "1212121212",
    "websiteClaimed": true,
    "accountLevelIssues": [
     {
      "id": "home_page_issue",
      "title": "Website URL not provided",
      "severity": "critical",
      "documentation": "https://support.google.com/merchants/answer/176793"
     },
     {
      "id": "missing_ad_words_link",
      "title": "No Google Ads account linked",
      "severity": "error",
      "documentation": "https://support.google.com/merchants/answer/6159060"
     }
    ],
    "products": [
     {
      "channel": "online",
      "destination": "Shopping",
      "country": "US",
      "statistics": {
       "active": "0",
       "pending": "0",
       "disapproved": "0",
       "expiring": "0"
      }
     }
    ]
   }
  },
  {
   "batchId": 99,
   "accountStatus": {
    "kind": "content#accountStatus",
    "accountId": "1313131313",
    "websiteClaimed": true,
    "accountLevelIssues": [
     {
      "id": "editorial_and_professional_standards_destination_url_down_policy",
      "title": "Account suspended due to policy violation: landing page not working",
      "country": "US",
      "severity": "critical",
      "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
     },
     {
      "id": "missing_ad_words_link",
      "title": "No Google Ads account linked",
      "severity": "error",
      "documentation": "https://support.google.com/merchants/answer/6159060"
     }
    ],
    "products": [
     {
      "channel": "online",
      "destination": "Shopping",
      "country": "US",
      "statistics": {
       "active": "0",
       "pending": "0",
       "disapproved": "0",
       "expiring": "0"
      }
     }
    ]
   }
  }
 ]
}

Kiểm tra tài nguyên Trạng thái tài khoản

Trong ví dụ sau, chúng ta lấy trạng thái tài khoản custombatch.get và liệt kê cho Tài khoản nhiều khách hàng (MCA):

Lấy trạng thái tài khoản phụ cho MCA bằng cách sử dụng accountstatuses.get.
1. Nhận merchantId và accountId bằng cách thực hiện GET cho API điểm cuối:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses/accountId
```
2. Bạn sẽ nhận được mã trạng thái HTTP 200 để thành công và tài khoản danh sách trạng thái trong JSON.
Xem tất cả trạng thái tài khoản phụ của một MCA bằng cách sử dụng accountstatuses.list.
1. Thực hiện phương thức GET đến điểm cuối của API bằng merchantId:
```
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
```
2. Bạn sẽ nhận được mã trạng thái HTTP 200 để thành công và tài khoản danh sách trạng thái ở định dạng JSON cho merchantId đã gửi.
Xem nhiều tài khoản phụ của MCA ở chế độ hàng loạt bằng cách sử dụng accountstatuses.custombatch.
1. Tạo JSON hợp lệ bằng accountID, merchant ID và get .
2. Thực hiện POST tới điểm cuối của API:
```
POST https://shoppingcontent.googleapis.com/content/v2.1/accountstatuses/batch
```
3. Bạn sẽ nhận được mã trạng thái HTTP 200 để thành công và tài khoản danh sách trạng thái trong JSON.