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

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

    1. ดึงข้อมูลการสมัครใช้บริการที่โอนได้ทั้งหมดสำหรับลูกค้า เพื่อให้ทราบว่าสามารถโอนการสมัครใช้บริการได้หรือไม่ และทราบจำนวนใบอนุญาตผู้ใช้ขั้นต่ำสำหรับการโอน
    2. โอนการสมัครใช้บริการ

  • ส่งคืน Multiple teams exist on this domain โดเมนนี้มีลูกค้าที่เป็นทีมตั้งแต่ 1 รายขึ้นไปเชื่อมโยงอยู่ ในการเพิ่มทีมอื่นในโดเมนนี้ โปรดทำตามขั้นตอนต่อไปนี้

    1. สั่งซื้อบัญชีของลูกค้า
    2. หากต้องการสร้างลูกค้าที่ได้รับการยืนยันด้วยโดเมนสำหรับโดเมน โปรดขอให้ลูกค้าสมัครใช้บริการโดยตรงผ่าน Google และยืนยันโดเมนของลูกค้าเพื่อเข้าควบคุมทีมที่มีอยู่ จากนั้นโอนการสมัครใช้บริการไปยังบัญชีของคุณ

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

    1. ยืนยันว่าบันทึกลูกค้าไม่ได้เก็บข้อมูลลูกค้าเก่าที่ชื่อโดเมนหลักของลูกค้าและตัวระบุลูกค้า Google ที่ไม่ซ้ำกันอาจไม่ตรงกัน เมื่อคืนสิทธิบัญชี Google ที่ลบไปแล้วก่อนหน้านี้ ระบบจะถือว่าเป็นบัญชีใหม่และมีค่า customerId ใหม่ แม้ว่าบัญชีอาจรักษาค่า customerDomain เดิมไว้ก็ตาม
    2. สั่งซื้อบัญชีลูกค้าใหม่
    3. สร้างการสมัครใช้บริการ สำหรับบัญชีลูกค้าใหม่นี้

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

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