แก้ปัญหาเกี่ยวกับ 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 Console แล้วเปิดใช้ 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 call โทรออกจนกว่าคุณจะได้รับการตอบกลับ 200
   3. หลังจากยืนยันโดเมนแล้ว ให้เปลี่ยนชื่อผู้ใช้ชั่วคราวโดยใช้ วิธีใดวิธีหนึ่งต่อไปนี้ users.patch หรือ users.update

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

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

412:limitExceeded

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

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