กำหนดค่าแอป

หากต้องการเริ่มใช้ Google Photos API ให้กําหนดค่าโปรเจ็กต์โดยเปิดใช้ Photos API ที่ต้องการโดยใช้คอนโซล Google API และตั้งค่ารหัสไคลเอ็นต์ OAuth 2.0

แอปพลิเคชันของคุณโต้ตอบกับ Google Photos ในนามของผู้ใช้ Google Photos ตัวอย่างเช่น เมื่อคุณสร้างอัลบั้มในคลัง Google Photos ของผู้ใช้หรืออัปโหลดรายการสื่อไปยังบัญชี Google Photos ของผู้ใช้ ผู้ใช้จะให้สิทธิ์คําขอ API เหล่านี้โดยใช้โปรโตคอล OAuth 2.0

รหัสไคลเอ็นต์ OAuth 2.0 ช่วยให้ผู้ใช้แอปพลิเคชันลงชื่อเข้าใช้ ตรวจสอบสิทธิ์ และสามารถใช้ Photos API ได้ Photos API ไม่รองรับบัญชีบริการ ผู้ใช้ต้องลงชื่อเข้าใช้บัญชี Google ที่ถูกต้องจึงจะใช้ API เหล่านี้ได้

กำหนดค่าแอป

ขั้นแรกให้เปิดใช้ API แล้วขอรหัสไคลเอ็นต์ OAuth 2.0

เปิดใช้ API

คุณต้องเปิดใช้ Photos API ในโปรเจ็กต์ก่อนจึงจะใช้ API ดังกล่าวได้

1. ไปที่คอนโซล Google API
2. จากแถบเมนู ให้เลือกโปรเจ็กต์หรือสร้างโปรเจ็กต์ใหม่
3. หากต้องการเปิด Google Photos API รายการใดรายการหนึ่ง จากเมนูการนำทาง ให้เลือกAPI และบริการ > ไลบรารี
4. ค้นหา "Photos" เลือก Photos API อย่างน้อย 1 รายการ แล้วคลิกเปิดใช้

หมายเหตุ: เมื่อค้นหา Google API คุณอาจเห็น "Google Picker API" ด้วย ซึ่งแตกต่างจาก Google Photos Picker API

ขอรหัสไคลเอ็นต์ OAuth 2.0

ทำตามขั้นตอนต่อไปนี้เพื่อขอรหัสไคลเอ็นต์ OAuth และกำหนดค่าสำหรับแอปพลิเคชัน ตัวอย่างนี้ใช้แอปพลิเคชันที่จัดการขั้นตอน OAuth ทั้งหมดฝั่งเซิร์ฟเวอร์ เช่น ตัวอย่างในแอปพลิเคชันของเรา ขั้นตอนการตั้งค่าอาจแตกต่างกันไปในสถานการณ์การติดตั้งใช้งานอื่นๆ

1. ไปที่คอนโซล Google API แล้วเลือกโปรเจ็กต์
2. จากเมนู ให้เลือก API และบริการ > ข้อมูลเข้าสู่ระบบ

3. ในหน้าข้อมูลเข้าสู่ระบบ ให้คลิกสร้างข้อมูลเข้าสู่ระบบ > รหัสไคลเอ็นต์ OAuth

   หมายเหตุ: หากกำลังตั้งค่าโปรเจ็กต์ใหม่ ระบบอาจแจ้งให้คุณกำหนดค่าหน้าจอความยินยอมของโปรเจ็กต์

4. เลือกประเภทแอปพลิเคชัน ในตัวอย่างนี้ ประเภทแอปพลิเคชันคือเว็บแอปพลิเคชัน

5. ลงทะเบียนต้นทางที่แอปได้รับอนุญาตให้เข้าถึง Google API ดังนี้

   1. ป้อนชื่อเพื่อระบุรหัสไคลเอ็นต์

   2. ในช่องต้นทางของ JavaScript ที่ได้รับอนุญาต ให้ป้อนต้นทางของแอป ช่องนี้ไม่อนุญาตให้ใช้ไวลด์การ์ด

      คุณสามารถป้อนต้นทางหลายรายการเพื่อให้แอปทำงานในโปรโตคอล โดเมน หรือโดเมนย่อยที่แตกต่างกันได้ URL ที่คุณป้อนได้รับอนุญาตให้เริ่มคําขอ OAuth

      ตัวอย่างต่อไปนี้แสดง URL การพัฒนาในเครื่อง (ตัวอย่างของเราใช้ localhost:8080) และ URL เวอร์ชันที่ใช้งานจริง

      http://localhost:8080
      https://myproductionurl.example.com
      

   3. ฟิลด์ URI การเปลี่ยนเส้นทางที่ได้รับอนุญาตคือปลายทางที่รับคําตอบจากเซิร์ฟเวอร์ OAuth 2.0 โดยปกติแล้ว ข้อมูลนี้รวมถึงสภาพแวดล้อมการพัฒนาและชี้ไปยังเส้นทางในแอปพลิเคชัน

      http://localhost:8080/auth/google/callback
      https://myproductionurl.example.com/auth/google/callback
      

   4. คลิกสร้าง

6. จากกล่องโต้ตอบไคลเอ็นต์ OAuth ที่ปรากฏขึ้น ให้คัดลอกข้อมูลต่อไปนี้

   • รหัสลูกค้า
   • รหัสลับไคลเอ็นต์

   แอปของคุณจะเข้าถึง Google API ที่เปิดใช้ได้โดยใช้ค่าเหล่านี้

แอปของคุณต้องได้รับการตรวจสอบโดย Google ก่อนจึงจะเปิดตัวแอปพลิเคชันสาธารณะที่เข้าถึง Photos API ได้ ข้อความ "แอปที่ยังไม่ยืนยัน" จะปรากฏบนหน้าจอเมื่อคุณทดสอบแอปพลิเคชันจนกว่าแอปจะได้รับการยืนยัน

หลังจากกําหนดค่าแอปแล้ว คุณก็พร้อมที่จะเริ่มต้นใช้งาน

• เริ่มต้นใช้งาน Picker API
• เริ่มต้นใช้งาน Library API

การเปลี่ยนรหัสไคลเอ็นต์

ทรัพยากรที่สร้างผ่าน Google Photos API ใดๆ จะเข้าถึงหรือแก้ไขได้โดยใช้รหัสไคลเอ็นต์เดิมที่ใช้สร้างเท่านั้น ตัวอย่างเช่น หากคุณสร้าง session ใน Picker API ด้วยรหัสไคลเอ็นต์ที่เฉพาะเจาะจง และต่อมาเปลี่ยนรหัสไคลเอ็นต์นั้นในแอป แอปจะเสียสิทธิ์เข้าถึงทรัพยากร API ที่สร้างขึ้นด้วยรหัสไคลเอ็นต์ก่อนหน้า

วางแผนอย่างรอบคอบและเลือกประเภทรหัสไคลเอ็นต์ที่ถูกต้องสำหรับ Photos API ที่คุณใช้ เปลี่ยนรหัสไคลเอ็นต์เฉพาะในกรณีที่จําเป็นอย่างยิ่งเพื่อหลีกเลี่ยงปัญหาการเข้าถึง