เริ่มต้นใช้งาน REST

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

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

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

กำหนดค่าแอป

เปิดใช้ API

คุณต้องเปิดใช้ Library API ให้กับโปรเจ็กต์ก่อนจึงจะใช้ Library API ได้

  1. ไปที่คอนโซล Google API
  2. จากแถบเมนู ให้เลือกโปรเจ็กต์หรือสร้างโปรเจ็กต์ใหม่
  3. หากต้องการเปิดไลบรารี Google API ให้เลือก API และบริการ > ไลบรารีจากเมนูการนำทาง
  4. ค้นหา "Google Photos Library 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. คลิกสร้าง

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

    • Client-ID
    • รหัสลับไคลเอ็นต์

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

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

ทดลองใช้ตัวอย่าง

เมื่อคุณกำหนดค่าโปรเจ็กต์เพื่อใช้กับ Library API แล้ว ให้ลองดูแอปตัวอย่างใน GitHub แอปตัวอย่างจะแสดงวิธีสร้างกรอบรูปอัจฉริยะโดยใช้ Library API