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

Bạn có thể sử dụng tài nguyên accountstatuses để xem trạng thái của tài khoản Merchant Center hoặc MCA (tài khoản nhiều khách hàng) và tất cả tài khoản phụ liên kết với tài khoả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 trên các trang web riêng biệt có thể chọn có tài khoản phụ trong Tài khoản nhiều khách hàng (MCA).

Người bán có trách nhiệm tuân thủ các chính sách của quảng cáo Mua sắmtrang thông tin miễn phí. 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 phát hiện thấy nội dung hoặc hành vi vi phạm những chính sách này.

Hã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 của một tài khoản người bán.

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

Dưới đây là yêu cầu mẫu, trong đó merchantId là mã tài khoản MCA và accountId là tài khoản phụ của MCA đó:

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

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

Phương thức này trả về các vấn đề ở cấp tài khoản và cấp mặt hàng. Bạn có thể sử dụng các tài nguyên Quảng cáo Mua sắmTrang thông tin miễn phí để khắc phục sự cố accountLevelIssues được trả về trong phản hồi từ 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 vi phạm "trang đích không hoạt động".

{
 "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ả các tài khoản phụ của Tài khoản nhiều khách hàng (MCA).

Bạn có thể sử dụng bộ lọc với accountstatuses.list để lọc vấn đề về sản phẩm theo điểm đến. Khi bạn không chỉ định đích đến, phản hồi sẽ bao gồm các trạng thái cho 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 merchantId của MCA:

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

Dưới đây là câu trả lờ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 MCA (ví dụ: tài khoản Merchant Center độc lập) sẽ trả về lỗi 403.

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

{
 "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 có phương thức GET sẽ trả về thông tin trạng thái tài khoản cho nhiều tài khoản phụ trong một 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ụ, batchId riêng biệt và method được đặt thành get.

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

Dưới đây là nội dung JSON của yêu cầu mẫu:

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

Dưới đâ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 tôi sẽ lấy danh sách và trạng thái tài khoản custombatch.get cho tài khoản nhiều khách hàng:

  1. Xem trạng thái tài khoản phụ của Tài khoản nhiều khách hàng bằng accountstatuses.get.

    1. Lấy merchantIdaccountId bằng cách thực hiện GET cho điểm cuối API:

      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 nếu đã thành công và danh sách trạng thái tài khoản trong JSON.

  2. Xem tất cả trạng thái tài khoản phụ của MCA bằng accountstatuses.list.

    1. Thực hiện GET cho điểm cuối API bằng merchantId của bạn:

      GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/accountstatuses
      
    2. Bạn sẽ nhận được mã trạng thái HTTP 200 nếu đã gửi thành công và danh sách trạng thái tài khoản trong JSON cho merchantId đã gửi.

  3. Xem nhiều tài khoản phụ của MCA ở chế độ hàng loạt bằng accountstatuses.custombatch.

    1. Tạo JSON hợp lệ bằng cách sử dụng phương thức accountID, merchant IDget.

    2. Thực hiện POST tới điểm cuối 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 nếu đã thành công và danh sách trạng thái tài khoản trong JSON.