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

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

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

एल्बम बनाने के लिए, आपके पास photoslibrary.appendonly स्कोप होना चाहिए.

एल्बम बनाने के बाद उनके टाइटल या कवर फ़ोटो को बदलने के लिए, 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"
}

एल्बम की जानकारी पाना

आपके ऐप्लिकेशन से बनाए गए किसी मौजूदा एल्बम की जानकारी पाने के लिए, albums.get को कॉल करें और उस एल्बम का albumId शामिल करें जिसकी जानकारी आपको चाहिए.

कॉल से एल्बम मिलता है.

REST

यहां जीईटी अनुरोध का हेडर दिया गया है:

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

अनुरोध का मुख्य हिस्सा कुछ ऐसा दिखता है:

{
  "albumId": album-id
}

अगर सफल होता है, तो जवाब एल्बम:

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

एल्बम के टाइटल और कवर फ़ोटो बदलना

किसी एल्बम का टाइटल या कवर फ़ोटो बदलने के लिए, इसके आइडेंटिफ़ायर वाला 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"
}

किसी एल्बम में मीडिया आइटम जोड़ें

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

किसी एल्बम से मीडिया आइटम हटाना

आप अपने ऐप्लिकेशन के ज़रिए बनाए गए मीडिया आइटम को कॉल किया जा रहा है albums.batchRemoveMediaItems.

अमान्य मीडिया आइटम चुने जाने पर पूरा अनुरोध पूरा नहीं होगा. कुछ हद तक सफलता समर्थित नहीं है.

किसी एल्बम से मीडिया आइटम हटाने के लिए, albums.batchRemoveMediaItems मीडिया आइटम और एल्बम के आइडेंटिफ़ायर के साथ.

REST

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

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
}