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

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

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

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

1. เปิดคอนโซล Google Cloud

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

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

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

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

6. หากต้องการเรียกดูตำแหน่งของโปรเจ็กต์ ให้คลิกเรียกดู

7. คลิกสถานที่ของโครงการแล้วคลิกเลือก

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

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

2. เปิดใช้ API

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

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

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

หมายเหตุ: Cloud Search API ที่ต่างกันจะต้องใช้บัญชีในการดำเนินการที่แตกต่างกัน (ผู้ดูแลระบบ บริการ และผู้ใช้) ดูข้อมูลเพิ่มเติมได้ที่ เอกสารอ้างอิงสำหรับวิธีที่คุณ ที่ต้องการโทร

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

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

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

4. ระบุที่อยู่อีเมล

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

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

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

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

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

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

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

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

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 ควรแสดงข้อมูลในที่เก็บ