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

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

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

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

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

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

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

ตัวเลือกในการดาวน์โหลดไลบรารีของไคลเอ็นต์มีดังนี้

การขึ้นต่อกันของ Gradle:

หากต้องการใช้ไลบรารีนี้กับ Gradle ให้เพิ่ม Dependency ต่อไปนี้ลงในไฟล์ build.gradle
```
repositories {
  mavenCentral()
}
dependencies {
  compile 'com.google.photos.library:google-photos-library-client:1.7.3'
}
```
Dependency ของ Maven:

หากต้องการใช้ไลบรารีนี้กับ Maven ให้เพิ่มรายการต่อไปนี้ลงใน Maven ของคุณ pom.xml
```
<dependency>
  <groupId>com.google.photos.library</groupId>
  <artifactId>google-photos-library-client</artifactId>
  <version>1.7.3</version>
</dependency>
```
วิธีดาวน์โหลดรุ่น

หน้าผลงาน มีอาร์ติแฟกต์ที่แตกต่างกันสำหรับไลบรารีแต่ละรุ่น รวมถึงไฟล์ jar
โคลนที่เก็บ:

ใช้วิธีนี้หากต้องการเปลี่ยนแปลงหรือมีส่วนร่วมในไลบรารีนี้ เช่น การส่งคำขอดึง หรือหากต้องการลองใช้ตัวอย่างของเรา เมื่อคุณโคลนที่เก็บข้อมูล ระบบจะดาวน์โหลดไฟล์ทั้งหมดในที่เก็บข้อมูลนี้
1. เรียกใช้ git clone https://github.com/google/java-photoslibrary.git ใน Command Prompt
2. คุณจะได้รับไดเรกทอรี java-photoslibrary ไปที่หน้าดังกล่าวโดยเรียกใช้ cd java-photoslibrary
3. เปิดไฟล์ build.gradle ใน IDE หรือเรียกใช้ ./gradlew assemble ที่ Command Prompt เพื่อสร้างโปรเจ็กต์ ดู ./gradlew tasks เพื่อดูงานที่มี

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

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

ระบุการกำหนดค่า OAuth ของลูกค้าใน CredentialsProvider เมื่อสร้าง PhotoLibrarySettings สำหรับออบเจ็กต์ PhotosLibraryClient

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

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

// Set up the Photos Library Client that interacts with the API
PhotosLibrarySettings settings =
     PhotosLibrarySettings.newBuilder()
    .setCredentialsProvider(
        FixedCredentialsProvider.create(/* Add credentials here. */)) 
    .build();

try (PhotosLibraryClient photosLibraryClient =
    PhotosLibraryClient.initialize(settings)) {

    // Create a new Album  with at title
    Album createdAlbum = photosLibraryClient.createAlbum("My Album");

    // Get some properties from the album, such as its ID and product URL
    String id = album.getId();
    String url = album.getProductUrl();

} catch (ApiException e) {
    // Error during album creation
}

มีตัวอย่างเพิ่มเติมให้คุณลองใช้บน GitHub