ในการเรียกและอัปเดตข้อมูลลูกค้าโดยใช้ API ของผู้ค้าปลีก คุณมี 1 ใน 2 วิธีในการค้นหาลูกค้า ดังนี้
- ตัวระบุที่ไม่ซ้ำกันของลูกค้า เช่น
C0123456
- ชื่อโดเมนของลูกค้า เช่น
example.com
ดึงข้อมูลบัญชีของลูกค้า
หากต้องการดึงข้อมูลบัญชีของลูกค้า ให้ใช้คำขอ GET
ต่อไปนี้และใส่โทเค็นการให้สิทธิ์
GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID
แทนที่ CUSTOMER_ID
ด้วยตัวระบุที่ไม่ซ้ำกันหรือชื่อโดเมนของลูกค้า
การตอบกลับ
เมื่อเรียกข้อมูลบัญชีของลูกค้า คุณอาจได้รับการตอบกลับอย่างใดอย่างหนึ่งต่อไปนี้
แสดงการตั้งค่าของลูกค้าแบบเต็ม ลูกค้าดังกล่าวเป็นหนึ่งในลูกค้าเดิม คุณสามารถใช้ตัวแทนจําหน่าย API คุณสามารถจัดการการตั้งค่าบัญชีและการสมัครใช้บริการของลูกค้ารายนี้ได้
ส่งคืนข้อมูลบัญชีขั้นต่ำของลูกค้า หากการตอบกลับแสดงผล
customerId
,customerDomain
และcustomerType
เท่านั้น Google หรือตัวแทนจำหน่ายรายอื่นจะจัดการลูกค้า คุณไม่สามารถสร้างลูกค้าที่ยืนยันด้วยอีเมลอีกรายสำหรับลูกค้าได้ หากต้องการจัดการลูกค้ารายนี้ ให้ทำตามขั้นตอนต่อไปนี้- ดึงข้อมูลการสมัครใช้บริการที่โอนได้ทั้งหมดสำหรับลูกค้า เพื่อให้ทราบว่าสามารถโอนการสมัครใช้บริการได้หรือไม่ และทราบจำนวนใบอนุญาตผู้ใช้ขั้นต่ำสำหรับการโอน
- โอนการสมัครใช้บริการ
ส่งคืน
Multiple teams exist on this domain
โดเมนนี้มีลูกค้าที่เป็นทีมตั้งแต่ 1 รายขึ้นไปเชื่อมโยงอยู่ ในการเพิ่มทีมอื่นในโดเมนนี้ โปรดทำตามขั้นตอนต่อไปนี้- สั่งซื้อบัญชีของลูกค้า
- หากต้องการสร้างลูกค้าที่ได้รับการยืนยันด้วยโดเมนสำหรับโดเมน โปรดขอให้ลูกค้าสมัครใช้บริการโดยตรงผ่าน Google และยืนยันโดเมนของลูกค้าเพื่อเข้าควบคุมทีมที่มีอยู่ จากนั้นโอนการสมัครใช้บริการไปยังบัญชีของคุณ
แสดงผลข้อผิดพลาด HTTP
404
ลูกค้ายังใหม่กับ Google และไม่มีบัญชี หากต้องการจัดการลูกค้ารายนี้ ให้ทำตามขั้นตอนต่อไปนี้- ยืนยันว่าบันทึกลูกค้าไม่ได้เก็บข้อมูลลูกค้าเก่าที่ชื่อโดเมนหลักของลูกค้าและตัวระบุลูกค้า Google ที่ไม่ซ้ำกันอาจไม่ตรงกัน เมื่อคืนสิทธิบัญชี Google ที่ลบไปแล้วก่อนหน้านี้ ระบบจะถือว่าเป็นบัญชีใหม่และมีค่า
customerId
ใหม่ แม้ว่าบัญชีอาจรักษาค่าcustomerDomain
เดิมไว้ก็ตาม - สั่งซื้อบัญชีลูกค้าใหม่
- สร้างการสมัครใช้บริการ สำหรับบัญชีลูกค้าใหม่นี้
- ยืนยันว่าบันทึกลูกค้าไม่ได้เก็บข้อมูลลูกค้าเก่าที่ชื่อโดเมนหลักของลูกค้าและตัวระบุลูกค้า Google ที่ไม่ซ้ำกันอาจไม่ตรงกัน เมื่อคืนสิทธิบัญชี Google ที่ลบไปแล้วก่อนหน้านี้ ระบบจะถือว่าเป็นบัญชีใหม่และมีค่า
อัปเดตการตั้งค่าของลูกค้า
เมื่อใช้ API ของตัวแทนจำหน่าย คุณจะอัปเดต customerType
ไม่ได้ แต่จะยืนยันโดเมนของลูกค้า team
และเป็นลูกค้า domain
ได้
หากต้องการอัปเดตการตั้งค่าของลูกค้า ให้ใช้คำขอ PUT
ต่อไปนี้และใส่ตัวระบุที่ไม่ซ้ำกันสำหรับลูกค้า
PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID
เนื้อหาคำขอ JSON จะอัปเดตการตั้งค่าของลูกค้าดังต่อไปนี้
{ "customerId": "C0CUSTOMER_ID123456", "customerDomain": "DOMAIN_NAME", "postalAddress": { "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE" }, "alternateEmail": "EMAIL_ADDRESS" }
แทนที่รายการต่อไปนี้
DOMAIN_NAME
: โดเมนของลูกค้า เช่นexample.com
NAME
: ชื่อลูกค้า เช่นAlex Cruz
ORGANIZATION_NAME
: ชื่อองค์กรของลูกค้า เช่นExample Organization
POSTAL_CODE
: รหัสไปรษณีย์ของลูกค้า เช่น94043
COUNTRY_CODE
: รหัสประเทศ ISO 2 อักขระของลูกค้าEMAIL_ADDRESS
: อีเมลของลูกค้า เช่นcruz@example.com
การตอบกลับ JSON ที่ประสบความสำเร็จจะแสดงรหัสสถานะ HTTP 200
และการตั้งค่าลูกค้าที่ได้รับการอัปเดต ดังนี้
{ "kind": "reseller#customer", "customerId": "CUSTOMER_ID", "customerDomain": "DOMAIN_NAME", "postalAddress": { "kind": "customers#address", "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE", }, "alternateEmail": "EMAIL_ADDRESS" }