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

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

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

เมื่อใช้ Reseller 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"
}