แก้ปัญหาเกี่ยวกับ Directory API

หน้านี้อธิบายปัญหาที่พบได้ทั่วไปซึ่งคุณอาจพบเกี่ยวกับ Directory API ในฐานะตัวแทนจำหน่าย

400:badRequest

ข้อผิดพลาดนี้เกิดขึ้นเมื่อมีการส่งค่าพารามิเตอร์ที่ไม่ถูกต้องไปยังเมธอด

หากใช้เมธอด users.get ให้ยืนยันว่าค่าที่ส่งผ่านไปยัง userKey คืออีเมลหลัก อีเมลแทนของผู้ใช้ หรือ รหัสผู้ใช้ที่ไม่ซ้ำกัน

หากใช้เมธอด users.list ให้ยืนยันพารามิเตอร์ต่อไปนี้

• พารามิเตอร์ customer: ใช้เฉพาะ customerId ที่สร้างโดย Google อย่าใช้โดเมนของลูกค้าจริง เราขอแนะนำให้ใช้ เนื่องจากหากลูกค้ามีโดเมนรอง โดยใช้พารามิเตอร์ domain จะแสดงผลผู้ใช้ที่มีที่อยู่อีเมลในโดเมนนั้นเท่านั้น
• พารามิเตอร์ domain: ใช้โดเมนของลูกค้าจริงเท่านั้น อย่าใช้
  customerId ที่ Google สร้างขึ้น

403:domainCannotUseApis

ข้อผิดพลาดนี้เกิดขึ้นเมื่อลูกค้าของคุณปิดการเข้าถึงของตัวแทนจำหน่าย Admin SDK API หากต้องการแก้ไขปัญหานี้ โปรดขอให้ลูกค้าเปิดใช้การเข้าถึงอีกครั้ง Admin SDK API สำหรับข้อมูลเพิ่มเติม โปรดดู ควบคุมการเข้าถึง API

หากคุณพยายามดูจำนวนผู้ใช้ที่มีใบอนุญาตปัจจุบันและคุณได้รับ แทนการเรียกใช้เมธอด users.list ให้ใช้ฟิลด์ licensedNumberOfSeats จากแหล่งข้อมูลการสมัครใช้บริการ

403:forbidden

ข้อผิดพลาดนี้เกิดขึ้นเมื่อคุณไม่ได้เป็นเจ้าของลูกค้า หรือลูกค้าปิดใช้ การเข้าถึงคอนโซลผู้ดูแลระบบของผู้ค้าปลีก

ในการแก้ไขปัญหานี้ โปรดโทรไปที่ customers.get วิธี ก่อนโทรเพื่อยืนยันการเป็นเจ้าของ ตัวแทนจำหน่าย ของลูกค้า หรือ ถาม ลูกค้าเพื่อเปิดใช้การเข้าถึงคอนโซลผู้ดูแลระบบของผู้ค้าปลีกอีกครั้ง สำหรับข้อมูลเพิ่มเติม ดูข้อมูลได้ที่ เข้าถึงคอนโซลผู้ดูแลระบบของลูกค้า

403:usageLimits.accessNotConfigured

ข้อผิดพลาดนี้เกิดขึ้นเมื่อไม่ได้เปิดใช้ API ในโปรเจ็กต์ Google Cloud เพื่อแก้ไขปัญหา ปัญหานี้ ให้ไปที่คอนโซล Google Cloud และเปิดใช้ API สำหรับข้อมูลเพิ่มเติม ดูข้อมูลได้ที่ เปิดใช้ Google Workspace API

409:duplicate

ข้อผิดพลาดนี้เกิดขึ้นเมื่อคุณพยายามจะเพิ่มผู้ใช้ใหม่ แต่คำขอ มีอีเมลหลักอยู่ในหนึ่งในรายการต่อไปนี้แล้ว:

• บัญชี Google Workspace ปัจจุบันที่คุณพยายามเพิ่ม
• ผลิตภัณฑ์อื่นของ Google (ไม่ใช่ Google Workspace)

โปรดดำเนินการดังนี้เพื่อแก้ไขปัญหา

1. เรียกใช้เมธอด users.get

   หากคุณได้รับการตอบกลับ 200 แสดงว่ามีผู้ใช้รายดังกล่าวในบัญชีของลูกค้าแล้ว บัญชี Google Workspace คุณเพิ่มผู้ใช้รายนี้ลงในบัญชีไม่ได้

   หากคุณได้รับการตอบกลับ 403 forbidden แสดงว่าโดเมนในโดเมนหลัก พารามิเตอร์อีเมลไม่ใช่ลูกค้าจากพาร์ทเนอร์ หรือมีการใช้อีเมลหลักแล้ว ก่อนหน้านี้สำหรับผลิตภัณฑ์อื่นของ Google และโดเมนของลูกค้าต้อง ต้องได้รับการยืนยันก่อนจึงจะเพิ่มผู้ใช้รายนี้ได้

2. หากยืนยันโดเมนของลูกค้าได้ ให้ทำดังนี้

   1. สร้างผู้ดูแลระบบชั่วคราวโดยใช้ users.insert วิธี และจัดสรรต่อไปในขั้นตอนสุดท้ายสำหรับการยืนยันโดเมน
   2. เมื่อยืนยันโดเมน ให้เพิ่มผู้ใช้ชั่วคราวลงใน owners[] พารามิเตอร์ของเนื้อหาคำขอสำหรับ webResource.insert สาย โปรดโทรออกจนกว่าจะได้รับการตอบกลับว่า 200
   3. หลังจากยืนยันโดเมนแล้ว ให้เปลี่ยนชื่อชื่อผู้ใช้ชั่วคราวโดยใช้ อย่างใดอย่างหนึ่ง users.patch หรือ users.update

3. หากยืนยันโดเมนของลูกค้าไม่ได้ ให้ทำดังนี้

   1. สร้างผู้ดูแลระบบชั่วคราวโดยใช้ users.insert วิธี
   2. ให้ลูกค้าลงชื่อเข้าใช้ในฐานะผู้ใช้ชั่วคราวและยืนยัน ผ่านคอนโซลผู้ดูแลระบบ
   3. หลังจากโดเมนได้รับการยืนยันแล้ว ลูกค้าหรือคุณจะเปลี่ยนชื่อ ชื่อผู้ใช้ชั่วคราว คุณสามารถใช้ users.patch หรือ users.update

412:limitExceeded

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

• สำหรับ FLEXIBLE ให้เพิ่มพารามิเตอร์ maximumNumberOfSeats
• สำหรับ ANNUAL ให้เพิ่มพารามิเตอร์ numberOfSeats