เริ่มต้นใช้งานบริการช็อปปิ้งแบบเปรียบเทียบสินค้า (CSS)

การดำเนินการพื้นฐานด้วย API เป็นวิธีที่ดีในการเริ่มต้นใช้งาน

ข้อกำหนดเบื้องต้น

โปรดทำสิ่งต่อไปนี้ให้เสร็จก่อนที่จะเริ่มต้น

  • ตรวจสอบว่าคุณมีบัญชี CSS Center ที่ใช้งานได้
  • ลงทะเบียนนักพัฒนา API
  • ตรวจสอบว่าการตั้งค่าสิทธิ์ถูกต้อง
  • ยืนยันว่าคุณได้เปิดใช้ CSS API แล้ว
  • ตรวจสอบว่าคุณได้ติดตั้งไลบรารีของไคลเอ็นต์สำหรับสภาพแวดล้อมแล้ว

ดูข้อมูลเพิ่มเติมได้ที่การเริ่มต้นอย่างรวดเร็ว

เปิดใช้ CSS API

หากต้องการลงทะเบียนเป็นนักพัฒนาแอปเพื่อใช้ CSS API คุณต้องลิงก์บัญชี CSS Center และโปรเจ็กต์ Google Cloud โดยใช้วิธีการลงทะเบียนนักพัฒนาแอป ดังนี้

ลิงก์ CSS Center กับโปรเจ็กต์ Google Cloud: ระบบจะสร้างลิงก์โดยอัตโนมัติ เนื่องจากผู้เรียกมีสิทธิ์เข้าถึงโปรเจ็กต์ Google Cloud ตามโทเค็นเพื่อเข้าถึงหรือคีย์ API และเป็นผู้ใช้ที่ได้รับอนุญาตของบัญชี CSS Center

ลงทะเบียนนักพัฒนา API

เพิ่มผู้ใช้ที่เป็นนักพัฒนา API ลงในบัญชี CSS Center: หากมีผู้ใช้ดังกล่าวอยู่แล้ว ระบบจะให้สิทธิ์เข้าถึงประเภทใหม่ "นักพัฒนา API" แก่ผู้ใช้รายนั้น ในกรณีที่เป็นผู้ใช้ใหม่ ผู้ใช้จะได้รับคำเชิญทางอีเมลของ CSS Center

หลังจากลงทะเบียนแล้ว คุณจะดูสถานะการลงทะเบียนได้โดยใช้ GetDeveloperRegistration หรือยกเลิกการลงทะเบียนโดยใช้ UnregisterGCP คุณใช้การเรียกการลงทะเบียนต่อไปนี้ได้

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

หลังจากเรียกใช้คำขอสำเร็จแล้ว คุณจะได้รับการตอบกลับดังนี้

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

ผลิตภัณฑ์ CSS

CSS API จะแยกความแตกต่างระหว่าง CssProductInput กับ ListCssProduct เช่นเดียวกับ Sub-API ของผลิตภัณฑ์ แทรก ผลิตภัณฑ์ที่มี InsertCssProductInput

เมื่อระบบภายในประมวลผลผลิตภัณฑ์แล้ว (อาจใช้เวลา 2-3 นาที) ให้เรียกข้อมูลด้วย ListCssProducts

ระบุผลิตภัณฑ์โดยใช้ raw_provided_id เราขอแนะนำให้คุณใช้ ตัวระบุที่คุณใช้อยู่แล้วในระบบของคุณเอง หรือจะใช้วิธีทั่วไป ในการสร้างก็ได้ โดยใช้อย่างใดอย่างหนึ่งต่อไปนี้

  • ตัวระบุที่ไม่ซ้ำกันทั่วโลก (GUID)
  • ตัวระบุที่ไม่ซ้ำกับผู้อื่น (UUID)
  • แอตทริบิวต์ผลิตภัณฑ์ที่ไม่ซ้ำกันที่ต่อกัน (เช่น brand_model_color_size)

ดูข้อมูลเพิ่มเติมได้ที่แทรก/แสดง/อัปเดต/ลบผลิตภัณฑ์

การดำเนินการพื้นฐาน

ต่อไปนี้คือคำขอพื้นฐานบางส่วนที่คุณลองใช้ได้

  1. แทรกผลิตภัณฑ์ทดสอบโดยใช้ InsertCssProductInput หากต้องการความช่วยเหลือเกี่ยวกับแอตทริบิวต์ที่จะส่ง โปรดดูโค้ด ตัวอย่างนี้

  2. แสดงผลิตภัณฑ์ทั้งหมดโดยใช้ ListCssProducts โปรดทราบว่าอาจมีความล่าช้าในการประมวลผลเล็กน้อยระหว่างการแทรกผลิตภัณฑ์กับ การปรากฏของผลิตภัณฑ์ในข้อมูล หากไม่เห็นรหัสในทันที โปรดลองอีกครั้งหลังจาก ผ่านไปสักครู่

  3. อัปเดตผลิตภัณฑ์รายการเดียวโดยใช้ UpdateCssProductInput โดยใช้ cssproductinput.name คุณต้องส่งเฉพาะแอตทริบิวต์ที่ต้องอัปเดต ดูตัวอย่างได้ที่โค้ดตัวอย่าง

  4. ลบผลิตภัณฑ์ทดสอบโดยใช้ DeleteCssProductInpu โดยระบุ raw_provided_id

ข้อจำกัด

การแทรกหรือลบผลิตภัณฑ์แต่ละรายการอาจใช้เวลานาน หากต้องการปรับปรุงประสิทธิภาพ ให้ใช้ Async เพื่อปรับปรุงประสิทธิภาพ ซึ่งช่วยให้เรียกใช้ API แบบขนานได้

แสดงรายการและติดป้ายกำกับบัญชี

การจัดการป้ายกำกับใน CSS API ช่วยให้คุณจัดระเบียบบัญชี Merchant Center ของลูกค้า โดยใช้แท็กที่กำหนดเองได้แบบเป็นโปรแกรม ฟีเจอร์นี้ช่วยให้คุณจัดหมวดหมู่ลูกค้าได้อย่างมีประสิทธิภาพ (เช่น ตามประเภทหรือกลยุทธ์) ซึ่งจะช่วยให้ จัดระเบียบได้ดีขึ้นและปรับปรุงการดำเนินงานให้มีประสิทธิภาพ คุณสามารถใช้ API เพื่อดำเนินการต่อไปนี้กับป้ายกำกับได้