ทั้งพาร์ทเนอร์ Shopping และบัญชีผู้ขายบุคคลธรรมดามีลิงก์ที่ได้รับแจ้งว่าลิงก์บัญชีของตนกับบัญชีอื่นๆ ได้หลายรายการ
เมธอด listlinks
จะแสดงรายการลิงก์เหล่านี้ทั้งหมดสำหรับบัญชี Merchant Center ที่ใช้การเรียก API โดยไม่จำเป็นต้องใช้พารามิเตอร์ใดๆ และจะเรียกใช้โดยใช้คำขอ HTTP GET
สถานะบริการ
เมื่อระบุลิงก์ คำตอบจะแสดง status
สำหรับ service
แต่ละรายการภายในลิงก์ ผู้ขายมีตัวเลือกในการอนุมัติบริการทั้งหมดที่แสดงหรือเฉพาะบางส่วนของบริการที่เสนอไว้ในคำขอ
บริการจะเริ่มต้นในสถานะ pending
จนกว่าจะได้รับอนุมัติจากผู้ขายอย่างชัดเจน หลังจากได้รับอนุมัติ บริการจะมีสถานะเป็น active
บริการที่ถูกนำออกจะแสดงสถานะ inactive
หากมีบริการ pending
หรือ active
อื่นๆ อยู่ด้วย เมื่อนำบริการทั้งหมดที่ประกอบด้วยลิงก์ออกแล้ว เมธอด listlinks
จะไม่แสดงลิงก์นั้นอีกต่อไป
ตัวอย่างคำขอ
หากต้องการแสดงรายการคำขอลิงก์ที่ส่งโดยพาร์ทเนอร์ 123456789
ให้ส่งคำขอ GET
ที่ไม่มีพารามิเตอร์โดยใช้เมธอด listlinks
GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks
ตัวอย่างการตอบกลับ
ในตัวอย่างนี้ ผู้ขาย 98765
ยังไม่ได้อนุมัติคำขอ ดังนั้นบริการแต่ละรายการจะมีสถานะ pending
{
"linkedAccountId": "98765",
"services": [
{
"service": "shoppingAdsProductManagement",
"status": "pending"
},
{
"service": "shoppingActionsOrderManagement",
"status": "pending"
}
]
}
ส่วนถัดไปจะอธิบายวิธีอนุมัติคำขอลิงก์