เริ่มต้นใช้งานไลบรารีของไคลเอ็นต์ PHP

หากต้องการเริ่มใช้ Google Photos API กับไลบรารีของไคลเอ็นต์ PHP คุณจะต้องตั้งค่าไลบรารีของไคลเอ็นต์ในสภาพแวดล้อมการพัฒนา แต่ก่อนที่จะดำเนินการดังกล่าว ให้กำหนดค่าโปรเจ็กต์โดยเปิดใช้ 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 ไม่รองรับ บัญชีบริการ หากต้องการใช้ API นี้ ผู้ใช้ต้องลงชื่อเข้าใช้บัญชี Google ที่ถูกต้อง บัญชี

กำหนดค่าแอป

เปิดใช้ API

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

ไปที่คอนโซล Google API
จากแถบเมนู ให้เลือกโปรเจ็กต์หรือสร้างโปรเจ็กต์ใหม่
หากต้องการเปิดไลบรารี Google API จากเมนูการนำทาง ให้เลือกAPI และบริการ > ไลบรารี
ค้นหา "Google Photos API" เลือกผลลัพธ์ที่ถูกต้อง แล้วคลิกเปิดใช้

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

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

ไปที่คอนโซล Google API แล้วเลือกโปรเจ็กต์
จากเมนู ให้เลือก API และบริการ > ข้อมูลเข้าสู่ระบบ
ในหน้าข้อมูลเข้าสู่ระบบ ให้คลิกสร้างข้อมูลเข้าสู่ระบบ > รหัสไคลเอ็นต์ OAuth
เลือกประเภทแอปพลิเคชัน ในตัวอย่างนี้ ประเภทแอปพลิเคชันคือ เว็บแอปพลิเคชัน
ลงทะเบียนต้นทางที่แอปได้รับอนุญาตให้เข้าถึง Google APIs ดังนี้
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. คลิกสร้าง

จากกล่องโต้ตอบไคลเอ็นต์ OAuth ที่ปรากฏขึ้น ให้ดาวน์โหลดไฟล์ JSON ที่มีการกำหนดค่าไคลเอ็นต์ รายละเอียดลูกค้าของคุณประกอบด้วยข้อมูลต่อไปนี้
- Client-ID
- รหัสลับไคลเอ็นต์
ระบบจะใช้ไฟล์ JSON นี้เพื่อตั้งค่าในภายหลัง ไลบรารีการตรวจสอบสิทธิ์ของ Google สำหรับ PHP ซึ่งทำงานร่วมกับไลบรารีของไคลเอ็นต์นี้

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

ตั้งค่าไลบรารีของไคลเอ็นต์

ไลบรารีของไคลเอ็นต์ PHP จะจัดการการเรียก API แบ็กเอนด์ทั้งหมดให้คุณ และแสดงออบเจ็กต์ที่ใช้งานง่าย รวมถึงตัวอย่างโค้ดสําหรับงาน API ทั่วไป ขั้นแรก ให้ดาวน์โหลดและติดตั้งไลบรารีของไคลเอ็นต์ Google Photos API สำหรับ PHP ควบคู่กับ ทรัพยากร Dependency จาก GitHub จากนั้นให้ตั้งค่าข้อมูลเข้าสู่ระบบ OAuth2 สำหรับ PHP

ตัวเลือกการดาวน์โหลด

ใช้ Composer เพื่อรวมไลบรารีไว้เป็นทรัพยากร Dependency ในสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ของคุณ เรียกใช้คำสั่งต่อไปนี้เพื่อเพิ่มไลบรารีลงในการกำหนดค่าโปรเจ็กต์และดาวน์โหลดลงในไดเรกทอรี vendor/

composer require google/photos-library

หรือจะโคลนที่เก็บหรือดาวน์โหลดไฟล์ tarball ที่บีบอัดก็ได้

ตั้งค่าข้อมูลเข้าสู่ระบบ OAuth2 สำหรับ PHP

ไลบรารีของไคลเอ็นต์นี้ใช้ได้กับไลบรารี Google Auth สำหรับ PHP สำหรับข้อมูลเพิ่มเติม โปรดดูที่การใช้ OAuth 2.0 กับไลบรารีของไคลเอ็นต์ Google API สำหรับ PHP

ใช้ข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ที่ไลบรารีการตรวจสอบสิทธิ์ส่งคืนมาเมื่อตั้งค่า PhotosLibraryClient

ลองฟังตัวอย่างเพลง

ลองใช้โค้ดด้านล่างเพื่อทำการเรียก API ครั้งแรกของคุณโดยใช้ไลบรารีไคลเอ็นต์ PHP

use Google\Auth\Credentials\UserRefreshCredentials;
use Google\Photos\Library\V1\PhotosLibraryClient;
use Google\Photos\Library\V1\PhotosLibraryResourceFactory;

try {
    // Use the OAuth flow provided by the Google API Client Auth library
    // to authenticate users. See the file /src/common/common.php in the samples for a complete
    // authentication example.
    $authCredentials = new UserRefreshCredentials( /* Add your scope, client secret and refresh token here */ );

    // Set up the Photos Library Client that interacts with the API
    $photosLibraryClient = new PhotosLibraryClient(['credentials' => $authCredentials]);

    // Create a new Album object with at title
    $newAlbum = PhotosLibraryResourceFactory::album("My Album");

    // Make the call to the Library API to create the new album
    $createdAlbum = $photosLibraryClient->createAlbum($newAlbum);

    // The creation call returns the ID of the new album
    $albumId = $createdAlbum->getId();
} catch (\Google\ApiCore\ApiException $exception) {
    // Error during album creation
} catch (\Google\ApiCore\ValidationException $e) {
    // Error during client creation
    echo $exception;
}

ยังมีอีก ตัวอย่างใน GitHub ให้คุณได้ลองใช้