แก้ปัญหาเกี่ยวกับ 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

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

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