एल्बम मैनेज करना

Google Photos में, एल्बम का इस्तेमाल करके फ़ोटो और अन्य मीडिया आइटम व्यवस्थित किए जा सकते हैं. एक मीडिया आइटम को एक या ज़्यादा एल्बम के साथ जोड़ा जा सकता है. असोसिएट करने के लिए मीडिया आइटम के लिए, आपको पहले एल्बम बनाना होगा.

अनुमति के ज़रूरी दायरे

एल्बम बनाने के लिए, आपके ऐप्लिकेशन को इनमें से कम से कम किसी एक का अनुरोध करना होगा अनुमति के दायरे:

  • photoslibrary.appendonly
  • photoslibrary.sharing

एल्बम बनाने के बाद उनका शीर्षक या कवर फ़ोटो बदलने के लिए, photoslibrary.edit.appcreateddata दायरा.

नया एल्बम बनाना

एल्बम बनाने के लिए, इस नंबर पर कॉल करें albums.create और शामिल करने के लिए title. ध्यान दें कि title में 500 से ज़्यादा वर्ण इस्तेमाल नहीं किए जा सकते.

कॉल एल्बम के लिए है. आपका ऐप्लिकेशन ये काम कर सकता है इस जानकारी से एल्बम आईडी संग्रहित करें और मीडिया आइटम अपलोड करना उस एल्बम को हाइलाइट करें.

आराम

यहां पोस्ट अनुरोध का हेडर दिया गया है:

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 से ज़्यादा वर्ण नहीं हो सकते. कवर मीडिया आइटम मालिकाना हक एल्बम के मालिक के पास होना चाहिए और एल्बम से जुड़े होने चाहिए. ये उस एल्बम के कवर होंगे के लिए.

आराम

एल्बम की title और coverPhotomediaItemId.

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

इस अनुरोध से तय होता है कि कौनसी प्रॉपर्टी अपडेट की जा रही हैं. इसके लिए, ये शामिल किए जा रहे हैं फ़ील्ड मास्क, जिसे updateMask पैरामीटर से दिखाया जाता है यूआरएल. हर एक के लिए 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 मीडिया आइटम और एल्बम के आइडेंटिफ़ायर के साथ.

आराम

यहां पोस्ट अनुरोध का हेडर दिया गया है:

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 रिस्पॉन्स और एचटीटीपी दिखाता है सफलता की स्थिति.

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 मीडिया आइटम और एल्बम के आइडेंटिफ़ायर के साथ.

आराम

यहां पोस्ट अनुरोध का हेडर दिया गया है:

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 रिस्पॉन्स और एचटीटीपी दिखाता है सफलता की स्थिति.

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
}