บริการช็อปปิ้งแบบเปรียบเทียบสินค้า (CSS) แสดงโฆษณา Shopping บน Google ในนามของผู้ขายในประเทศที่โปรแกรม CSS พร้อมให้บริการได้ Content API ช่วยให้โดเมน CSS และกลุ่ม CSS จัดระเบียบบัญชีที่เชื่อมโยงได้โดยใช้ป้ายกำกับ โดเมน CSS จะแสดงรายการ ติดป้ายกำกับ และกรองบัญชี Merchant Center ที่เชื่อมโยงกับโดเมนได้ กลุ่ม CSS จะติดป้ายกำกับและแสดงรายการโดเมน CSS ที่เชื่อมโยงกับกลุ่มได้ บริการ Content API เหล่านี้มีความเทียบเท่าแบบเป็นโปรแกรมกับฟีเจอร์บางอย่างที่มีใน Comparison Shopping Service Center
ดูข้อมูลเพิ่มเติมเกี่ยวกับ CSS ได้ที่บริการช็อปปิ้งแบบเปรียบเทียบสินค้า ดูข้อมูลเกี่ยวกับการทำงานกับป้ายกำกับใน CSS Center ได้ที่ใช้ป้ายกำกับบัญชีใน Comparison Shopping Service Center
ประเภทบัญชี CSS
CSS ใช้บัญชี 3 ประเภทต่อไปนี้
- กลุ่ม CSS คือบัญชีระดับบนสุดที่มีโดเมน CSS อย่างน้อย 1 โดเมน
- โดเมน CSS คือบัญชีสำหรับ CSS ที่แสดงโฆษณา Shopping ในนามของผู้ขาย โดเมน CSS แต่ละรายการจะอยู่ในกลุ่ม CSS ได้เพียงกลุ่มเดียวเท่านั้น
- บัญชี Merchant Center คือผู้ขายที่โดเมน CSS แสดงโฆษณา Shopping CSS จะเชื่อมโยงกับบัญชี Merchant Center ประเภทต่างๆ รวมถึงบัญชีหลายลูกค้า (MCA) และบัญชีผู้ขายบุคคลธรรมดา บัญชี Merchant Center แต่ละบัญชีจะเชื่อมโยงกับโดเมน CSS ได้เพียงโดเมนเดียวเท่านั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับบัญชี Merchant Center ประเภทต่างๆ ได้ที่ประเภทบัญชีใน Comparison Shopping Service Center
ประเภทป้ายกำกับ CSS
CSS ใช้ป้ายกำกับ 2 ประเภท ได้แก่
- ป้ายกำกับที่กำหนดเองจะสร้างขึ้นและกำหนดให้กับบัญชี Merchant Center ตามโดเมน CSS และให้แก่โดเมน CSS ตามกลุ่ม CSS
- ป้ายกำกับอัตโนมัติจะสร้างขึ้นและมอบหมายให้กับบัญชี Merchant Center โดยอัตโนมัติโดย CSS Center ป้ายกำกับอัตโนมัติใช้ได้กับเมตริกบัญชีประเภทต่างๆ และช่วยคุณระบุบัญชีที่สำคัญและกิจกรรมในบัญชีที่สำคัญได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภทป้ายกำกับ รวมถึงป้ายกำกับอัตโนมัติที่มีได้ที่ใช้ป้ายกำกับบัญชีใน Comparison Shopping Service Center
ฟังก์ชันและปลายทางของ Content API สำหรับ CSS
Content API มีปลายทางต่อไปนี้สำหรับ CSS
accounts.labels
: ให้คุณสร้าง เรียกข้อมูล และแก้ไขป้ายกำกับเพื่อใช้กับโดเมน CSS และบัญชี Merchant Center ดูตัวอย่างได้ที่การสร้างป้ายกำกับaccounts.updatelabels
: ให้คุณใช้ป้ายกำกับกับบัญชี Merchant Center บัญชีเดียวได้ ดูตัวอย่างได้ที่การใช้ป้ายกำกับกับบัญชี Merchant Centeraccounts.list
: ช่วยให้คุณเรียกข้อมูลบัญชี Merchant Center ทั้งหมดที่เชื่อมโยงกับโดเมน CSS รวมถึงป้ายกำกับที่ใช้กับแต่ละบัญชี นอกจากนี้ คุณยังกรองตามป้ายกำกับid
เพื่อเรียกดูชุดย่อยของบัญชีที่เชื่อมโยงได้ด้วย ดูตัวอย่างได้ที่การใช้ป้ายกำกับเพื่อกรองบัญชี Merchant Centeraccounts.get
: ช่วยให้คุณเรียกดูป้ายกำกับที่ใช้กับบัญชี Merchant Center บัญชีเดียวได้csses
: ช่วยให้คุณดูและจัดการการเชื่อมโยงระหว่างป้ายกำกับกับโดเมน CSS ได้ ดูตัวอย่างได้ที่การใช้ป้ายกำกับกับโดเมน CSS
เมื่อเรียกใช้ปลายทาง accounts
ในฐานะโดเมน CSS โปรดคำนึงถึงข้อกำหนดต่อไปนี้
- โดเมน CSS ต้องระบุ
cssId
แทนmerchantId
- โดเมน CSS ต้องระบุพารามิเตอร์การค้นหา
view=CSS
- โดเมน CSS ต้องระบุรหัสบัญชี Merchant Center ที่เชื่อมโยงเป็น
accountId
ตัวอย่าง: สร้างป้ายกำกับ
คุณใช้เมธอด accounts.labels.create
เพื่อสร้างป้ายกำกับใหม่ได้ คุณจะใช้ป้ายกำกับกับโดเมน CSS และบัญชี Merchant Center ได้ อย่างไรก็ตาม ป้ายกำกับสำหรับบัญชีประเภทต่างๆ จะแยกกันและใช้แทนกันไม่ได้ หากต้องการสร้างป้ายกำกับระดับโดเมนซึ่งใช้ได้กับบัญชี Merchant Center ที่เชื่อมโยงกับโดเมน ให้ใช้รหัสโดเมน CSS เป็น accountId
เมื่อสร้างป้ายกำกับ หากต้องการสร้างป้ายกำกับระดับกลุ่มซึ่งใช้ได้กับโดเมน CSS ที่เชื่อมโยงกับกลุ่ม ให้ใช้รหัสกลุ่ม CSS เป็น accountId
เมื่อสร้างป้ายกำกับ
ตัวอย่างต่อไปนี้แสดงวิธีสร้างป้ายกำกับบัญชีคีย์ระดับโดเมน ซึ่งจะนําไปใช้กับบัญชี Merchant Center ที่เชื่อมโยงกับโดเมนได้ หากต้องการสร้างป้ายกำกับ ให้ส่งคำขอ POST
โดยใช้ URL ต่อไปนี้และเนื้อหาคำขอ
https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels
{
"name": "key-accounts",
"description": "All accounts with over a million products"
}
ตัวอย่าง: ใช้ป้ายกำกับกับบัญชี Merchant Center
คุณสามารถใช้เมธอด accounts.updatelabels
เพื่อกำหนดป้ายกำกับให้แก่บัญชี Merchant
Center ที่เชื่อมโยงกับโดเมน CSS ได้ ตัวอย่างต่อไปนี้สาธิตวิธีใช้ป้ายกำกับคีย์บัญชีที่สร้างไว้ในตัวอย่างก่อนหน้านี้กับบัญชี Merchant Center ที่สำคัญที่สุดบัญชีหนึ่ง
หากต้องการใช้ป้ายกำกับ ให้ส่งคำขอ POST
โดยใช้ URL ต่อไปนี้และเนื้อหาคำขอ
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/
{
"labelIds": [‘123’] // ‘key-accounts’
}
ตัวอย่างการใช้ป้ายกํากับเพื่อกรองบัญชี Merchant Center
หลังจากสร้างและใช้ป้ายกำกับกับบัญชี Merchant Center ที่เชื่อมโยงกับโดเมน CSS แล้ว คุณจะใช้เมธอด accounts.list
และส่งพารามิเตอร์การค้นหาป้ายกำกับในคำขอเพื่อแสดงเฉพาะบัญชีที่มีป้ายกำกับดังกล่าว ตัวอย่างต่อไปนี้แสดงวิธีกรองบัญชี Merchant Center ที่เชื่อมโยงกับโดเมน CSS โดยใช้ id
(123
) ของป้ายกำกับ key-accounts ที่สร้างในตัวอย่างการสร้างป้ายกำกับ หากต้องการเรียกข้อมูลบัญชี ให้ส่งคำขอ GET
โดยใช้ URL ต่อไปนี้
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123
ไม่จำเป็นต้องมีเนื้อหาคำขอ
ตัวอย่าง: ใช้ป้ายกำกับในโดเมน CSS
คุณยังใช้เมธอด csses.updatelabels
เพื่อกำหนดป้ายกำกับให้กับโดเมน CSS ที่เชื่อมโยงกับกลุ่ม CSS ได้ด้วย ตัวอย่างต่อไปนี้แสดงวิธีใช้ป้ายกำกับระดับกลุ่ม key-domains ที่สร้างโดยใช้เมธอด accounts.labels.create
กับบัญชีโดเมน CSS ที่สำคัญที่สุดบัญชีหนึ่งของคุณ โปรดทราบว่าป้ายกำกับสำหรับโดเมน CSS และบัญชี Merchant Center จะแยกกัน คุณต้องสร้างป้ายกำกับระดับกลุ่มโดยใช้รหัสกลุ่ม CSS เป็น accountId
หากต้องการใช้ป้ายกำกับ ให้ส่งคำขอ POST
โดยใช้ URL ต่อไปนี้และเนื้อหาคำขอ
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}