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

หากต้องการดึงและอัปเดตข้อมูลของลูกค้าโดยใช้ 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"
}