เรียกข้อมูลและอัปเดตข้อมูลบัญชีของลูกค้า

หากต้องการดึงและอัปเดตข้อมูลของลูกค้าโดยใช้ Reseller API คุณสามารถค้นหาลูกค้าได้ 2 วิธีดังนี้

ตัวระบุที่ไม่ซ้ำกันของลูกค้า เช่น C0123456
ชื่อโดเมนของลูกค้า เช่น example.com

ดึงข้อมูลบัญชีของลูกค้า

หากต้องการดึงข้อมูลบัญชีของลูกค้า ให้ใช้GETคำขอ ต่อไปนี้และรวมโทเค็นการให้สิทธิ์

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

แทนที่ CUSTOMER_ID ด้วยตัวระบุที่ไม่ซ้ำหรือชื่อโดเมนของลูกค้า

การตอบกลับ

เมื่อดึงข้อมูลบัญชีของลูกค้า คุณอาจได้รับการตอบกลับอย่างใดอย่างหนึ่งต่อไปนี้

แสดงการตั้งค่าลูกค้าทั้งหมด: ลูกค้าเป็นหนึ่งในลูกค้าเดิม คุณสามารถใช้ Reseller API เพื่อจัดการการตั้งค่าบัญชีและการสมัครใช้บริการของลูกค้า รายนี้ได้
แสดงข้อมูลบัญชีลูกค้าขั้นต่ำ: หากการตอบกลับแสดงเฉพาะ customerId, customerDomain และ customerType แสดงว่า Google หรือตัวแทนจำหน่ายรายอื่นเป็นผู้จัดการลูกค้า คุณไม่สามารถสร้างลูกค้าที่ยืนยันอีเมลอีกรายให้ได้ หากต้องการจัดการลูกค้ารายนี้ ให้ทำตามขั้นตอนต่อไปนี้
1. ดึงข้อมูลการสมัครใช้บริการทั้งหมดที่โอนได้สำหรับลูกค้า เพื่อทำความเข้าใจความสามารถในการโอนและจำนวนที่นั่งของผู้ใช้ขั้นต่ำ
2. โอนการสมัครใช้บริการ
ส่งคืน Multiple teams exist on this domain: โดเมนนี้มีลูกค้าที่เป็นทีมอย่างน้อย 1 รายที่เชื่อมโยงอยู่ หากต้องการเพิ่มทีมอื่นในโดเมนนี้ ให้ทำตามขั้นตอนต่อไปนี้
1. สั่งซื้อบัญชีลูกค้า
2. หากต้องการสร้างลูกค้าที่ยืนยันด้วยโดเมน ให้ขอให้ลูกค้า สมัครใช้บริการโดยตรงและยืนยันโดเมน จากนั้น โอนการสมัครใช้บริการ
แสดงข้อผิดพลาด HTTP 404: ลูกค้าเป็นผู้ใช้ใหม่ของ Google และไม่มีบัญชี หากต้องการจัดการลูกค้า ให้ทำตามขั้นตอนต่อไปนี้
1. ตรวจสอบว่าบันทึกไม่มีข้อมูลลูกค้าเก่าซึ่งไม่ตรงกัน ระหว่างชื่อโดเมนหลักกับตัวระบุลูกค้า Google ที่ไม่ซ้ำกัน เมื่อคืนสิทธิให้บัญชีที่ถูกลบ ระบบจะถือว่าบัญชีดังกล่าวเป็น บัญชีใหม่ที่มี customerId ใหม่
2. สั่งซื้อบัญชีลูกค้าใหม่
3. สร้างการสมัครใช้บริการ สำหรับบัญชีลูกค้าใหม่

อัปเดตการตั้งค่าของลูกค้า

คุณจะอัปเดต customerType โดยใช้ Reseller API ไม่ได้ แต่ คุณสามารถยืนยันโดเมนของลูกค้า 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"
}