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

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

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

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

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

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

2. เปิดใช้ API

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

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

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

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

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

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

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

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

1. ใน คอนโซล Google Cloud ให้เลือกโปรเจ็กต์
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 แสดงข้อมูลของคุณ