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

หากต้องการดึงและอัปเดตข้อมูลของลูกค้าโดยใช้ 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. หากต้องการสร้างลูกค้าที่ยืนยันด้วยโดเมนสำหรับโดเมน ให้ขอให้ลูกค้า ซื้อการสมัครใช้บริการโดยตรงผ่าน Google และยืนยันโดเมน รับช่วงทีมที่มีอยู่ จากนั้น โอนการสมัครใช้บริการไปยังบัญชีของคุณ

  • แสดงข้อผิดพลาด HTTP 404 ลูกค้าเป็นผู้ใช้ใหม่ของ Google และไม่มีบัญชี หากต้องการจัดการลูกค้า ให้ทำตามขั้นตอนต่อไปนี้

    1. ยืนยันว่าบันทึกลูกค้าไม่มีข้อมูลลูกค้าเก่าซึ่งอาจทำให้ชื่อโดเมนหลักของลูกค้าและตัวระบุลูกค้า Google ที่ไม่ซ้ำกันไม่ตรงกัน เมื่อมีการคืนสิทธิบัญชี Google ที่ลบไปก่อนหน้านี้ ระบบจะถือว่าเป็นบัญชีใหม่และมีcustomerId ใหม่ แม้ว่าบัญชีอาจยังคงมีcustomerDomain เดิมอยู่ก็ตาม
    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: รหัสประเทศแบบ 2 อักขระตามมาตรฐาน ISO ของลูกค้า
  • 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"
}