กำหนดค่าการเข้าถึง Google Cloud Search API

คุณต้องกำหนดค่าการเข้าถึง Google Cloud Search API ก่อนจึงจะใช้ API นี้ได้ ไม่ว่าจะใช้โดยตรงหรือผ่าน SDK เอกสารนี้ ครอบคลุมขั้นตอนที่จำเป็นในการใช้ Google Cloud Search API REST API

1. สร้างโปรเจ็กต์ API

หากต้องการเปิดใช้ API คุณต้องสร้างโปรเจ็กต์ Google Cloud ก่อน โปรเจ็กต์นี้เป็นพื้นฐานสำหรับการสร้าง การเปิดใช้ และการใช้บริการ Google Cloud ทั้งหมด ซึ่งรวมถึงการจัดการ API, การเปิดใช้การเรียกเก็บเงิน, การเพิ่มและนำผู้ทำงานร่วมกันออก และการจัดการสิทธิ์

1. เปิด Google Cloud Console

2. ที่ด้านบนของหน้า ให้คลิก arrow_drop_down ทางด้านขวาของ "Google Cloud Console" กล่องโต้ตอบที่แสดงโปรเจ็กต์ปัจจุบันจะปรากฏขึ้น

3. คลิกโปรเจ็กต์ใหม่ หน้าจอ "โปรเจ็กต์ใหม่" จะปรากฏขึ้น

4. ป้อนชื่อโปรเจ็กต์ในช่องชื่อโปรเจ็กต์

5. (ไม่บังคับ) คลิกแก้ไขเพื่อแก้ไขรหัสโปรเจ็กต์ คุณจะเปลี่ยนรหัสโปรเจ็กต์ไม่ได้หลังจากที่สร้างโปรเจ็กต์แล้ว ดังนั้นให้เลือกรหัสที่ตรงกับความต้องการของคุณตลอดอายุการใช้งานของโปรเจ็กต์

6. หากต้องการเรียกดูสถานที่สำหรับการฉายภาพ ให้คลิกเรียกดู

7. คลิกสถานที่ตั้งสำหรับโปรเจ็กต์ แล้วคลิกเลือก

8. คลิกสร้าง คอนโซลจะนำคุณไปยังหน้าแดชบอร์ด ระบบจะสร้างโปรเจ็กต์ ภายในไม่กี่นาที

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างและจัดการโปรเจ็กต์ได้ที่ การสร้างและจัดการโปรเจ็กต์

2. เปิดใช้ API

คุณต้องเปิดใช้ Google Cloud Search API และสร้างบัญชีบริการเพื่อรับข้อมูลเข้าสู่ระบบ

1. หากต้องการตรวจสอบว่าคุณอยู่ในโปรเจ็กต์ที่สร้างใหม่ ให้คลิกไอคอน arrow_drop_down ทางด้านขวาของ แบนเนอร์คอนโซล Google Cloud แล้วเลือกโปรเจ็กต์ที่สร้างใหม่
2. คลิกเปิดใช้ API และบริการ หน้า "ยินดีต้อนรับสู่ไลบรารี API" จะปรากฏขึ้น
3. ไปที่ Google Cloud Search API
4. คลิกเปิดใช้ หน้า "ภาพรวม" จะปรากฏขึ้น

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดและปิดใช้ API ได้ที่ จัดการ API ใน Google Cloud Console

3. สร้างข้อมูลเข้าสู่ระบบบัญชีบริการ

1. ใน Google Cloud Console คลิกข้อมูลเข้าสู่ระบบในการนำทางด้านซ้าย หน้าข้อมูลเข้าสู่ระบบจะปรากฏขึ้น
2. จากรายการแบบเลื่อนลงสร้างข้อมูลเข้าสู่ระบบ ให้เลือก บัญชีบริการ หน้า "สร้างบัญชีบริการ" จะปรากฏขึ้น
3. ป้อนชื่อในช่องชื่อบัญชีบริการ
4. (ไม่บังคับ) แก้ไขรหัสบัญชีบริการ
5. คลิกสร้าง หน้าจอ "สิทธิ์ของบัญชีบริการ" จะปรากฏขึ้น
6. คลิกต่อไป หน้าจอ "ให้สิทธิ์ผู้ใช้เข้าถึงบัญชีบริการนี้" จะปรากฏขึ้น
7. คลิกสร้างคีย์ แล้วคลิกเสร็จสิ้น กล่องโต้ตอบ "คีย์ส่วนตัวที่บันทึกไว้ในคอมพิวเตอร์" จะปรากฏขึ้นและระบบจะดาวน์โหลดสำเนาคีย์ส่วนตัวลงในคอมพิวเตอร์
8. คลิกปิด

ดูข้อมูลเพิ่มเติมเกี่ยวกับบัญชีบริการได้ที่ บัญชีบริการ เว็บแอปพลิเคชัน และแอปพลิเคชันที่ติดตั้ง

4. ระบุอีเมล

1. จาก Google Cloud Console เลือกโปรเจ็กต์ที่คุณสร้างไว้ที่ด้านบนของหน้า
2. คลิกเมนูการนำทางทางด้านซ้ายของแบนเนอร์ Google Cloud Console
3. คลิก IAM และผู้ดูแลระบบ > บัญชีบริการ
4. ในรายการ ภายใต้ "รหัสบัญชีบริการ" ให้จดอีเมลที่สร้างขึ้น ซึ่งระบุบัญชีบริการที่คุณกำหนดค่า ระบบใช้อีเมลนี้ เมื่อเพิ่มแหล่งข้อมูลลงใน Cloud Search

5. เริ่มต้นการสนับส��ุนจากบุคคลที่สาม

คุณต้องเริ่มต้นการรองรับบุคคลที่สามสำหรับ Google Cloud Search ก�������จ��������เ����ยกใช้ Cloud Search API อื่นๆ ได้

วิธีเริ่มต้นการรองรับบุคคลที่สามสำหรับ Cloud Search

1. โปรเจ็กต์แพลตฟอร์ม Cloud Search มีข้อมูลเข้าสู่ระบบบัญชีบริการ อย่างไรก็ตาม คุณต้องสร้างข้อมูลเข้าสู่ระบบของเว็บแอปพลิเคชันเพื่อเริ่มต้นการสนับสนุนบุคคลที่สาม ดูวิธีการสร้างข้อมูลเข้าสู่ระบบของเว็บแอปพลิเคชันได้ที่สร้างข้อมูลเข้าสู่ระบบ เมื่อทำขั้นตอนนี้เสร็จแล้ว คุณควรมีไฟล์รหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์

2. ใช้ OAuth 2 Playground ของ Google เพื่อรับโทเค็นเพื่อการเข้าถึง

   1. คลิกการตั้งค่า แล้วเลือกใช้ข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ของคุณเอง
   2. ป้อนรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์จากขั้นตอนที่ 1
   3. คลิกปิด
   4. ในช่องขอบเขต ให้พิมพ์ https://www.googleapis.com/auth/cloud_search.settings แล้วคลิกให้สิทธิ์ OAuth 2 Playground จะแสดงรหัสการให้สิทธิ์
   5. คลิกเปลี่ยนรหัสการให้สิทธิ์ของโทเค็น ระบบจะแสดงโทเค็น

3. หากต้องการเริ่มต้นการรองรับบุคคลที่สามสำหรับ Cloud Search ให้ใช้คำสั่ง curl ต่อไปนี้ อย่าลืมแทนที่ [YOUR_ACCESS_TOKEN] ด้วยโทเค็นที่ได้รับใน ขั้นตอนที่ 2

   curl --request POST \
   'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
     --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '{}' \
     --compressed
   

   หากทำสำเร็จ เน��้อหาการตอบกลับจะมีอินสแตนซ์ของ operation เช่น

   {
   name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
   }
   

   หากไม่สำเร็จ โปรดติดต่อทีมสนับสนุนของ Cloud Search

4. ใช้ operations.get เพื่อยืนยันว่าได้เริ่มต้นการสนับสนุนจากบุคคลที่สามแล้ว

   curl \
   'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key=
   [YOUR_API_KEY]' \
   --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
   --header 'Accept: application/json' \
   --compressed
   

   เมื่อการเริ่มต้นของบุคคลที่สามเสร็จสมบูรณ์แล้ว จะมีฟิลด์ done ตั้งค่าเป็น true เช่น

   {
   name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
   done: true
   }
   

ขั้นตอนถัดไป

ขั้นตอนถัดไปที่คุณอาจต้องดำเนินการมีดังนี้

1. หากวางแผนที่จะใช้ Google Cloud Search กับที่เก็บข้อมูลที่ไม่ใช่ของ Google เช่น Microsoft® SharePoint® คุณ ต้องสร้างแหล่งข้อมูล ดูวิธีการเพิ่มแหล่งข้อมูลได้ที่เพิ่มแหล่งข้อมูลเพื่อค้นหา

2. เมื่อตั้งค่าแหล่งข้อมูลแล้ว คุณจะสร้างและลงทะเบียนสคีมาเพื่อระบุวิธีที่ Google Cloud Search ควรแสดงข้อมูลในที่เก็บได้