สถานะบัญชี

คุณใช้แหล่งข้อมูล 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