สถานะบัญชี

คุณใช้แหล่งข้อมูล accountstatuses เพื่อดูสถานะบัญชี Merchant Center หรือ MCA (บัญชีหลายลูกค้า) และบัญชีย่อยทั้งหมดที่เชื่อมโยงกับบัญชีดังกล่าวได้

ผู้ขายที่มีร้านค้าออนไลน์หรือแบรนด์หลายรายการที่ขายในเว็บไซต์แยกต่างหากสามารถเลือกมีบัญชีย่อยภายใต้ MCA ได้

ผู้ขายมีหน้าที่ปฏิบัติตามนโยบายโฆษณา Shopping และข้อมูลที่แสดงฟรี Google Shopping ขอสงวนสิทธิ์ในการบังคับใช้นโยบายเหล่านี้และตอบกลับอย่างเหมาะสมหากเราพบเนื้อหาหรือพฤติกรรมที่ละเมิดนโยบายเหล่านี้

ดูรายละเอียดปัญหาทั่วไปเกี่ยวกับบัญชีได้ที่ข้อมูลอ้างอิงปัญหาเกี่ยวกับบัญชี

accountstatuses.get

คุณใช้ accountstatuses.get เพื่อดูข้อมูลสถานะบัญชีสำหรับบัญชีผู้ขายบัญชีเดียวได้

คุณใช้พารามิเตอร์ destination เพื่อควบคุมปัญหาเกี่ยวกับผลิตภัณฑ์ที่จะแสดงได้ เมื่อไม่ได้ระบุปลายทาง การตอบกลับเริ่มต้นจะมีสถานะของ destination: Shopping

ต่อไปนี้คือคำขอตัวอย่าง โดย merchantId คือรหัสบัญชี MCA และ accountId คือบัญชีย่อยของ MCA ดังกล่าว

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

หากต้องการรับข้อมูลสถานะบัญชีแบบสแตนด์อโลน โปรดโทรหา accountstatuses.get ด้วยรหัสบัญชีเดียวกันสำหรับ merchantId และ accountId

วิธีนี้จะส่งคืนปัญหาระดับบัญชีและระดับสินค้า คุณสามารถใช้ทรัพยากรสำหรับโฆษณา Shopping และข้อมูลที่แสดงฟรีเพื่อแก้ไขaccountLevelIssues ที่แสดงในการตอบกลับจาก accountstatuses.get

ต่อไปนี้เป็นตัวอย่างการตอบสนองสำหรับบัญชีย่อยที่ถูกระงับเนื่องจากละเมิด "หน้า Landing Page ไม่ทำงาน"

{
 "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

คุณใช้ accountstatuses.list เพื่อดูข้อมูลสถานะบัญชีในบัญชีย่อยทั้งหมดของ MCA ได้

คุณใช้ตัวกรองกับ accountstatuses.list เพื่อกรองปัญหาเกี่ยวกับผลิตภัณฑ์ตามปลายทางได้ เมื่อไม่ได้ระบุปลายทาง การตอบกลับจะแสดงสถานะของ destination: Shopping

ตัวอย่างคำขอรับข้อมูลสถานะบัญชีของบัญชีย่อยทั้งหมดภายใต้ MCA merchantId มีดังนี้

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

ต่อไปนี้คือตัวอย่างคำตอบ

{
 "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"
     }
    }
   ]
  }
 ]
}

การเรียก accountstatuses.list สำหรับบัญชีที่ไม่ใช่ MCA (เช่น บัญชี Merchant Center แบบสแตนด์อโลน) จะแสดงข้อผิดพลาด 403

ต่อไปนี้เป็นตัวอย่างการตอบสนองสำหรับการเรียกใช้ accountstatuses.list สำหรับบัญชีแบบสแตนด์อโลน

{
 "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'."
 }
}

โหมดกลุ่ม

accountstatuses.custombatch ที่ใช้เมธอด GET จะแสดงผลข้อมูลสถานะบัญชีสำหรับบัญชีย่อยหลายบัญชีในบัญชีหลายลูกค้า

JSON ของคำขอรวม merchantId ของหมายเลขบัญชี MCA, accountId ของบัญชีย่อย, batchId ที่ไม่ซ้ำกัน และ method ที่ตั้งค่าเป็น get

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

ต่อไปนี้เป็นตัวอย่างเนื้อหา JSON ของคำขอ:

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

เนื้อหาการตอบสนอง JSON มีดังนี้

{
 "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"
      }
     }
    ]
   }
  }
 ]
}

ทดสอบทรัพยากรสถานะบัญชี

ในตัวอย่างต่อไปนี้ เราได้ระบุ แสดง และสถานะบัญชี custombatch.get สำหรับบัญชี MCA

1. ดูสถานะบัญชีย่อยสำหรับ MCA โดยใช้ accountstatuses.get

   1. รับ merchantId และ accountId โดยดำเนินการ GET ไปยังปลายทาง API:

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

   2. คุณควรได้รับรหัสสถานะ HTTP 200 สำหรับดำเนินการสำเร็จและรายการสถานะบัญชีในรูปแบบ JSON

2. ดูสถานะบัญชีย่อยทั้งหมดสำหรับ MCA โดยใช้ accountstatuses.list

   1. ดำเนินการ GET ที่ปลายทาง API ด้วย merchantId:

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

   2. คุณควรได้รับรหัสสถานะ HTTP 200 สำหรับดำเนินการสำเร็จและรายการสถานะบัญชีในรูปแบบ JSON สำหรับ merchantId ที่ส่งมา

3. ดูบัญชีย่อยหลายบัญชีสำหรับ MCA ในโหมดกลุ่มโดยใช้ accountstatuses.custombatch

   1. สร้าง JSON ที่ถูกต้องโดยใช้เมธอด accountID, merchant ID และ get

   2. ดำเนินการ POST ไปยังปลายทาง API:

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

   3. คุณควรได้รับรหัสสถานะ HTTP 200 สำหรับดำเนินการสำเร็จและรายการสถานะบัญชีในรูปแบบ JSON