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

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

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

หากต้องการเปิดใช้ API ให้สร้างโปรเจ็กต์ Google Cloud ก่อน โปรเจ็กต์นี้เป็นรากฐานสำหรับการใช้บริการ Google Cloud, การจัดการ API และการตั้งค่าสิทธิ์

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

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

2. เปิดใช้ API

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

1. เลือกโปรเจ็กต์ใหม่จากเมนูแบบเลื่อนลงในแบนเนอร์ Google Cloud Console
2. คลิกเปิดใช้ API และบริการ
3. ค้นหาและเลือก Google Cloud Search API
4. คลิกเปิดใช้

ดูข้อมูลเพิ่มเติมได้ที่หัวข้อจัดการ API ใน Google Cloud Console

หมายเหตุ: เมธอด Cloud Search API ที่แตกต่างกันต้องใช้บัญชีประเภทต่างๆ (ผู้ดูแลระบบ บริการ หรือผู้ใช้) ดูรายละเอียดได้ในเอกสารประกอบอ้างอิง

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

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

ดูข้อมูลเพิ่มเติมได้ที่ บัญชีบริการ

4. ระบุอีเมลบัญชีบริการ

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

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

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

หมายเหตุ: หากทำตามบทแนะนำ Cloud Search จนเสร็จแล้ว คุณได้ เริ่มต้นการรองรับบุคคลที่สามแล้วและข้ามขั้นตอนนี้ได้

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

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

3. เรียกใช้คำสั่ง curl นี้ โดยแทนที่ [YOUR_ACCESS_TOKEN] ด้วยโทเค็นของคุณ

   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 หากไม่สำเร็จ โปรดติดต่อทีมสนับสนุนของ Cloud Search

4. ใช้ operations.get เพื่อยืนยันการเริ่มต้น

   curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
   --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
   --header 'Accept: application/json' \
   --compressed
   

   การเริ่มต้นจะเสร็จสมบูรณ์เมื่อ done เป็น true

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

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