Albümleri yönetme

Google Fotoğraflar'da, albümleri kullanarak fotoğrafları ve diğer medya öğelerini düzenleyebilirsiniz. Bir medya öğesi, bir veya daha fazla albümle ilişkilendirilebilir. İlişkilendirmeye başlamak için bir albüm içeren medya öğeleri varsa önce albümü oluşturmanız gerekir.

Gerekli yetkilendirme kapsamları

Albüm oluşturmak için photoslibrary.appendonly kapsamı gerekiyor.

Albüm oluşturulduktan sonra başlık veya kapak fotoğrafının değiştirilmesi photoslibrary.edit.appcreateddata kapsamı.

Kapsamlar hakkında daha fazla bilgi için Yetkilendirme kapsamları başlıklı makaleyi inceleyin.

Yeni albüm oluşturun

Albüm oluşturmak için şu numarayı arayın: albums.create ve dahil et title. title 500 karakterle sınırlıdır.

Arama bir albüm döndürür. Uygulamanız , bu bilgilerdeki albüm kimliğini saklayabilir ve bunu medya yüklemek öğeleri ilgili albüme ekleyin.

REST

Aşağıda, bir POST isteğinin üstbilgisi verilmiştir:

POST https://photoslibrary.googleapis.com/v1/albums
Content-type: application/json
Authorization: Bearer oauth2-token

İstek gövdesi şu şekilde görünür:

{
  "album": {
    "title": "new-album-title"
  }
}

Başarılı olursa yanıt bir albüm:

{
  "productUrl": "album-product-url",
  "id": "album-id",
  "title": "album-title",
  "isWriteable": "whether-you-can-write-to-this-album"
}

Albüm ayrıntılarını alma

Uygulamanız tarafından oluşturulan mevcut bir albümün ayrıntılarını almak için albums.get işlevini çağırın ve almak istediğiniz albümün albumId değerini ekleyin.

Arama bir albüm döndürür.

REST

Aşağıda, bir GET isteğinin üstbilgisini görebilirsiniz:

GET https://photoslibrary.googleapis.com/v1/albums/{albumId}
Content-type: application/json
Authorization: Bearer oauth2-token

İsteğin gövdesi aşağıdaki gibi görünür:

{
  "albumId": album-id
}

Başarılı olursa yanıt bir albüm:

{
  "id": album-id,
  "title": album-title,
  "productUrl": album-product-url,
  "mediaItemsCount": media-items-count,
  "coverPhotoBaseUrl": cover-photo-base-url,
  "coverPhotoMediaItemId": cover-photo-media-item-id
}

Albüm başlıklarını ve kapak fotoğraflarını değiştirme

Albüm başlığını veya kapak fotoğrafını değiştirmek için albümün tanımlayıcısıyla bir album update call oluşturun ve yeni başlığı ya da yeni kapak fotoğrafının medya öğesi kimliğini isteğe ekleyin. Değişikliği yapmak için photoslibrary.edit.appcreateddata authorization kapsamını kullanmanız gerekir.

Albüm başlıkları 500 karakterden uzun olamaz. Kapak medya öğeleri albüm sahibine ait olmalı ve kapak olacakları albüme ait olmalıdır .

REST

Bir albümün title ve coverPhotomediaItemId özelliklerini güncellemek için PATCH istek başlığını aşağıda bulabilirsiniz.

PATCH https://photoslibrary.googleapis.com/v1/albums/album-id?updateMask=title&updateMask=coverPhotoMediaItemId

Bu istek, updateMask parametreleriyle gösterilen bir alan maskesi URL'yi tıklayın. updateMask parametresinin her biri için iletilmesi gerekir güncellenmekte olan albüm özelliği.

Güncellediğiniz her mülk için ayrıntılarını istek gövdesi:

{
  "title": "new-album-title",
  "coverPhotoMediaItemId": "new-cover-media-item-id"
}

Başarılı olursa yanıt, güncellenmiş album değerini döndürür ayrıntılar:

{
  "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"
}

Bir albüme medya öğeleri ekleme

Uygulamanız tarafından oluşturulan medya öğelerini, uygulamanızın oluşturduğu albümlere eklemek için arama albums.batchAddMediaItems. Medya öğeleri, bu çağrıda belirtilen sırayla albümün sonuna eklenir.

Geçersiz bir medya öğesi veya albümü belirtilirse isteğin tamamı başarısız olur. Kısmi başarı desteklenmez.

Her albüm en fazla 20.000 medya öğesi içerebilir. Bu sınırı aşan daha fazla öğe ekleme istekleri başarısız olur.

Bir albüme medya öğeleri eklemek için şunu arayın: albums.batchAddMediaItems tanımlayıcılarını kullanır.

REST

Aşağıda, bir POST isteğinin üstbilgisi verilmiştir:

POST https://photoslibrary.googleapis.com/v1/albums/album-id:batchAddMediaItems
Content-type: application/json
Authorization: Bearer oauth2-token

İsteğin gövdesi aşağıdaki gibi görünür:

{
   "mediaItemIds": [
     "media-item-id",
     "another-media-item-id",
     ...
   ]
}

Başarılı olursa yanıt boş bir JSON yanıtı ve HTTP Başarı durumu.

Medya öğelerini albümden kaldırma

Uygulamanız tarafından oluşturulan medya öğelerini, uygulamanızın oluşturduğu albümlerden kaldırmak için arama albums.batchRemoveMediaItems.

Geçersiz medya öğeleri belirtilirse isteğin tamamı başarısız olur. Kısmi desteklenmez.

Medya öğelerini bir albümden kaldırmak için şunu arayın: albums.batchRemoveMediaItems tanımlayıcılarını kullanır.

REST

Aşağıda, bir POST isteğinin üstbilgisi verilmiştir:

POST https://photoslibrary.googleapis.com/v1/albums/album-id:batchRemoveMediaItems
Content-type: application/json
Authorization: Bearer oauth2-token

İsteğin gövdesi aşağıdaki gibi görünür:

{
   "mediaItemIds": [
     "media-item-id",
     "another-media-item-id",
     ...
   ]
}

Başarılı olursa yanıt boş bir JSON yanıtı ve HTTP Başarı durumu.

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
}