ใน Google Photos คุณสามารถจัดระเบียบรูปภาพและรายการสื่ออื่นๆ โดยใช้อัลบั้มได้ รายการสื่อสามารถเชื่อมโยงกับอัลบั้มได้อย่างน้อยหนึ่งอัลบั้ม หากต้องการเริ่มเชื่อมโยงรายการสื่อกับอัลบั้ม คุณต้องสร้างอัลบั้มก่อน
ขอบเขตการให้สิทธิ์ที่จำเป็น
หากต้องการสร้างอัลบั้ม แอปของคุณต้องขอขอบเขตการให้สิทธิ์ต่อไปนี้อย่างน้อย 1 รายการ
photoslibrary.appendonly
photoslibrary.sharing
หากต้องการเปลี่ยนชื่อหรือรูปภาพปกของอัลบั้มหลังจากสร้าง ให้ใช้ขอบเขต photoslibrary.edit.appcreateddata
การสร้างอัลบั้มใหม่
หากต้องการสร้างอัลบั้ม โปรดโทรหา
albums.create
แล้วรวม
title
โปรดทราบว่า title
มีอักขระได้ไม่เกิน 500 ตัว
การโทรแสดงผลอัลบั้ม แอปของคุณสามารถจัดเก็บรหัสอัลบั้มจากข้อมูลนี้และใช้สำหรับ การอัปโหลดรายการสื่อ ไปยังอัลบั้มที่เฉพาะเจาะจงได้
REST
ส่วนหัวของคำขอ POST มีดังนี้
POST https://photoslibrary.googleapis.com/v1/albums Content-type: application/json Authorization: Bearer oauth2-token
เนื้อหาของคำขอมีลักษณะดังนี้
{ "album": { "title": "new-album-title" } }
หากสำเร็จ ระบบจะตอบกลับเป็นอัลบั้ม
{ "productUrl": "album-product-url", "id": "album-id", "title": "album-title", "isWriteable": "whether-you-can-write-to-this-album" }
Java
try { Album createdAlbum = photosLibraryClient.createAlbum("My Album"); // The createdAlbum object contains properties of an album String productUrl = createdAlbum.getProductUrl(); // coverPhotoBaseUrl shouldn't be used as is. Append parameters to base URLs before use String albumCoverImage = createdAlbum.getCoverPhotoBaseUrl() + "=w2048-h1024"; boolean isWriteable = createdAlbum.getIsWriteable(); } catch (ApiException e) { // Handle error }
PHP
try { $newAlbum = PhotosLibraryResourceFactory::album("My Album"); $createdAlbum = $photosLibraryClient->createAlbum($newAlbum); // The createdAlbum object contains properties of an album $albumId = $createdAlbum->getId(); $productUrl = $createdAlbum->getProductUrl(); // coverPhotoBaseUrl shouldn't be used as is. Append parameters to base URLs before use $albumCoverImage = $createdAlbum->getCoverPhotoBaseUrl() . '=w2048-h1024'; $isWriteable = $createdAlbum->getIsWriteable(); } catch (\Google\ApiCore\ApiException $e) { // Handle error }
การเปลี่ยนชื่ออัลบั้มและรูปภาพปก
หากต้องการเปลี่ยนชื่ออัลบั้มหรือรูปภาพปก ให้สร้าง album update
call
พร้อมตัวระบุของอัลบั้ม และใส่ชื่อใหม่หรือรหัสรายการสื่อของรูปภาพปกใหม่ในคำขอ คุณจะต้องใช้ขอบเขตphotoslibrary.edit.appcreateddata
การให้สิทธิ์เพื่อทําการเปลี่ยนแปลง
ชื่ออัลบั้มต้องมีความยาวไม่เกิน 500 อักขระ รายการสื่อคัฟเวอร์ต้องเป็นของเจ้าของอัลบั้มและต้องเป็นของอัลบั้มนั้นๆ
REST
นี่คือส่วนหัวของคำขอแพตช์เพื่ออัปเดต title
และ coverPhotomediaItemId
ของอัลบั้ม
PATCH https://photoslibrary.googleapis.com/v1/albums/album-id?updateMask=title&updateMask=coverPhotoMediaItemId
คำขอนี้กำหนดว่าพร็อพเพอร์ตี้ใดกำลังได้รับการอัปเดตโดยรวม
ฟิลด์มาสก์ที่ระบุโดยพารามิเตอร์ updateMask
ใน
URL จำเป็นต้องส่งพารามิเตอร์ updateMask
สำหรับพร็อพเพอร์ตี้
อัลบั้มแต่ละรายการที่กำลังอัปเดต
สำหรับแต่ละพร็อพเพอร์ตี้ที่คุณกำลังอัปเดต ให้ใส่รายละเอียดในส่วนเนื้อหาของคำขอ ดังนี้
{ "title": "new-album-title", "coverPhotoMediaItemId": "new-cover-media-item-id" }
หากสําเร็จ การตอบกลับจะแสดงรายละเอียด album
ที่อัปเดตแล้ว ดังนี้
{ "id": "album-id", "title": "new-album-title", "productUrl": "album-product-url", "isWriteable": "true-if-user-can-write-to-this-album", "mediaItemsCount": "number-of-media-items-in-album", "coverPhotoBaseUrl": "cover-photo-base-url_use-only-with-parameters", "coverPhotoMediaItemId": "new-cover-media-item-id" }
Java
try { // Update the cover photo of the album given a MediaItem object. Album updatedAlbum = photosLibraryClient.updateAlbumCoverPhoto(album, newCoverMediaItem); // Alternatively, you can update the cover photo of the album given a media item ID. // The specified media item identifier must be not null or empty. // Album updatedAlbum = photosLibraryClient.updateAlbumCoverPhoto(album, "new-cover-media-item-id"); } catch (ApiException e) { // Handle error } try { // Update the title of the album. // The new title must not be null or empty. Album updatedAlbum = photosLibraryClient.updateAlbumTitle(album, "new-album-title"); } catch (ApiException e) { // Handle error }
PHP
try { // ID of the album to update. $albumId = "ALBUM_ID"; // Media item ID of the new cover photo. // Must not be null or empty. $newCoverMediaItemId = "new-cover-media-item-id"; // Update the cover photo of the album. $mediaItem = $photosLibraryClient->updateAlbumCoverPhoto($albumId, $newCoverMediaItemId); } catch (\Google\ApiCore\ApiException $e) { // Handle error } try { // ID of the album to update. $albumId = "ALBUM_ID"; // New title of the album. // Must not be null or empty. $newTitle = "new-album-title"; // Update the title of the album. $mediaItem = $photosLibraryClient->updateAlbumTitle($albumId, $newTitle); } catch (\Google\ApiCore\ApiException $e) { // Handle error }
การเพิ่มรายการสื่อในอัลบั้ม
คุณเพิ่มรายการสื่อจากคลังภาพ Google Photos ของผู้ใช้ไปยังอัลบั้มได้โดยโทรไปที่หมายเลข albums.batchAddMediaItems
ระบบจะเพิ่มรายการสื่อไว้ที่ท้ายอัลบั้มตามลำดับที่ระบุในการโทรนี้
คำขอทั้งหมดจะล้มเหลวหากมีการระบุรายการสื่อหรืออัลบั้มที่ไม่ถูกต้อง ไม่รองรับความสำเร็จบางส่วน
แต่ละอัลบั้มมีรายการสื่อได้สูงสุด 20,000 รายการ คำขอเพิ่มสินค้าอื่นๆ ที่จะเกินขีดจำกัดนี้จะไม่สำเร็จ
โปรดทราบว่าคุณเพิ่มได้เฉพาะรายการสื่อที่แอปพลิเคชันอัปโหลดไปยังอัลบั้มที่แอปพลิเคชันสร้างขึ้นเท่านั้น รายการสื่อต้องอยู่ในไลบรารีของผู้ใช้ด้วย สำหรับอัลบั้มที่แชร์ อัลบั้มดังกล่าวต้องเป็นของผู้ใช้ หรือผู้ใช้ต้องเป็นผู้ทำงานร่วมกันซึ่งเข้าร่วมอัลบั้มแล้ว
หากต้องการเพิ่มรายการสื่อในอัลบั้ม ให้เรียกใช้ albums.batchAddMediaItems
ด้วยตัวระบุของรายการสื่อและอัลบั้ม
REST
ส่วนหัวของคำขอ POST มีดังนี้
POST https://photoslibrary.googleapis.com/v1/albums/album-id:batchAddMediaItems Content-type: application/json Authorization: Bearer oauth2-token
เนื้อหาของคำขอมีลักษณะดังนี้
{ "mediaItemIds": [ "media-item-id", "another-media-item-id", ... ] }
หากสำเร็จ การตอบกลับจะแสดงการตอบกลับ JSON ที่ว่างเปล่าและสถานะ HTTP สำเร็จ
Java
try { // List of media item IDs to add List<String> mediaItemIds = Arrays .asList("MEDIA_ITEM_ID", "ANOTHER_MEDIA_ITEM_ID"); // ID of the album to add media items to String albumId = "ALBUM_ID"; // Add all given media items to the album photosLibraryClient.batchAddMediaItemsToAlbum(albumId, mediaItemIds); } catch (ApiException e) { // An exception is thrown if the media items could not be added }
PHP
try { // List of media item IDs to add $mediaItemIds = ["MEDIA_ITEM_ID", "ANOTHER_MEDIA_ITEM_ID"]; // ID of the album to add media items to $albumId = "ALBUM_ID"; // Add all given media items to the album $response = $photosLibraryClient->batchAddMediaItemsToAlbum($albumId, $mediaItemIds); } catch (\Google\ApiCore\ApiException $e) { // Handle Error }
การนำรายการสื่อออกจากอัลบั้ม
คุณนำรายการสื่อที่เพิ่มไว้ออกจากอัลบั้มได้โดยโทรหา albums.batchRemoveMediaItems
คำขอทั้งหมดจะล้มเหลวหากมีการระบุรายการสื่อที่ไม่ถูกต้อง ระบบไม่รองรับความสำเร็จบางส่วน
โปรดทราบว่าคุณสามารถนำออกได้เฉพาะรายการสื่อที่แอปพลิเคชันได้เพิ่มลงในอัลบั้มหรือที่ถูก สร้างในอัลบั้มโดยเป็นส่วนหนึ่งของการอัปโหลดเท่านั้น สำหรับอัลบั้มที่แชร์ คุณจะนำรายการที่ผู้ทำงานร่วมกันคนอื่นๆ เพิ่มออกได้ก็ต่อเมื่อคุณดำเนินการในนามของเจ้าของอัลบั้มเท่านั้น
หากต้องการนำรายการสื่อออกจากอัลบั้ม ให้เรียกใช้ albums.batchRemoveMediaItems
ด้วยตัวระบุของรายการสื่อและอัลบั้ม
REST
ส่วนหัวของคำขอ POST มีดังนี้
POST https://photoslibrary.googleapis.com/v1/albums/album-id:batchRemoveMediaItems Content-type: application/json Authorization: Bearer oauth2-token
เนื้อหาของคำขอมีลักษณะดังนี้
{ "mediaItemIds": [ "media-item-id", "another-media-item-id", ... ] }
หากสำเร็จ การตอบกลับจะแสดงการตอบกลับ JSON ที่ว่างเปล่าและสถานะ HTTP สำเร็จ
Java
try { // List of media item IDs to remove List<String> mediaItemIds = Arrays .asList("MEDIA_ITEM_ID", "ANOTHER_MEDIA_ITEM_ID"); // ID of the album to remove media items from String albumId = "ALBUM_ID"; // Remove all given media items from the album photosLibraryClient.batchRemoveMediaItemsFromAlbum(albumId, mediaItemIds); } catch (ApiException e) { // An exception is thrown if the media items could not be removed }
PHP
try { // List of media item IDs to remove $mediaItemIds = ["MEDIA_ITEM_ID", "ANOTHER_MEDIA_ITEM_ID"]; // ID of the album to remove media items from $albumId = "ALBUM_ID"; // Remove all given media items from the album $response = $photosLibraryClient->batchRemoveMediaItemsFromAlbum($albumId, $mediaItemIds); } catch (\Google\ApiCore\ApiException $e) { // Handle Error }