สถานะบัญชี

คุณสามารถใช้ accountstatuses แหล่งข้อมูลสำหรับดูสถานะของผู้ขาย บัญชี 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

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

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