অ্যালবাম পরিচালনা করুন

Google ফটোতে, আপনি অ্যালবাম ব্যবহার করে ফটো এবং অন্যান্য মিডিয়া আইটেমগুলি সংগঠিত করতে পারেন৷ একটি মিডিয়া আইটেম এক বা একাধিক অ্যালবামের সাথে যুক্ত হতে পারে। একটি অ্যালবামের সাথে মিডিয়া আইটেমগুলি সংযুক্ত করা শুরু করতে, আপনাকে প্রথমে অ্যালবাম তৈরি করতে হবে৷

প্রয়োজনীয় অনুমোদনের সুযোগ

একটি অ্যালবাম তৈরি করতে, আপনার অ্যাপকে অবশ্যই নিম্নলিখিত অনুমোদনের সুযোগগুলির মধ্যে অন্তত একটির অনুরোধ করতে হবে:

  • photoslibrary.appendonly
  • photoslibrary.sharing

অ্যালবাম তৈরির পরে তাদের শিরোনাম বা কভার ফটো পরিবর্তন করতে, photoslibrary.edit.appcreateddata স্কোপ ব্যবহার করুন।

একটি নতুন অ্যালবাম তৈরি করা হচ্ছে

একটি অ্যালবাম তৈরি করতে, albums.create কল করুন এবং title অন্তর্ভুক্ত করুন। মনে রাখবেন title 500 অক্ষরের মধ্যে সীমাবদ্ধ।

কল একটি অ্যালবাম ফিরে. আপনার অ্যাপ এই তথ্য থেকে অ্যালবাম আইডি সংরক্ষণ করতে পারে এবং নির্দিষ্ট অ্যালবামে মিডিয়া আইটেম আপলোড করার জন্য এটি ব্যবহার করতে পারে।

বিশ্রাম

এখানে একটি 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"
}

জাভা

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
}

পিএইচপি

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

এই অনুরোধটি নির্ধারণ করে যে কোন বৈশিষ্ট্যগুলি একটি ফিল্ড মাস্ক অন্তর্ভুক্ত করে আপডেট করা হচ্ছে, যা URL-এ 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"
}

জাভা

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
}

পিএইচপি

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
}

একটি অ্যালবামে মিডিয়া আইটেম যোগ করা হচ্ছে

আপনি albums.batchAddMediaItems কল করে একটি অ্যালবামে ব্যবহারকারীর Google ফটো লাইব্রেরি থেকে মিডিয়া আইটেম যোগ করতে পারেন। এই কলে প্রদত্ত ক্রমে মিডিয়া আইটেমগুলি অ্যালবামের শেষে যোগ করা হয়।

সম্পূর্ণ অনুরোধ ব্যর্থ হবে যদি একটি অবৈধ মিডিয়া আইটেম বা অ্যালবাম নির্দিষ্ট করা হয়। আংশিক সাফল্য সমর্থিত নয়।

প্রতিটি অ্যালবামে 20,000টি মিডিয়া আইটেম থাকতে পারে। এই সীমা অতিক্রম করবে এমন আরও আইটেম যোগ করার অনুরোধ ব্যর্থ হবে।

মনে রাখবেন যে আপনি শুধুমাত্র মিডিয়া আইটেমগুলি যোগ করতে পারেন যা আপনার অ্যাপ্লিকেশন দ্বারা আপলোড করা হয়েছে আপনার অ্যাপ্লিকেশন তৈরি করা অ্যালবামে ৷ মিডিয়া আইটেমগুলি অবশ্যই ব্যবহারকারীর লাইব্রেরিতে থাকতে হবে৷ শেয়ার করা অ্যালবামের জন্য, সেগুলি অবশ্যই ব্যবহারকারীর মালিকানাধীন হতে হবে বা ব্যবহারকারীকে অবশ্যই একজন সহযোগী হতে হবে যিনি ইতিমধ্যেই অ্যালবামে যোগ দিয়েছেন৷

একটি অ্যালবামে মিডিয়া আইটেম যোগ করতে, মিডিয়া আইটেম এবং অ্যালবামের শনাক্তকারীর সাথে albums.batchAddMediaItems কল করুন।

বিশ্রাম

এখানে একটি 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 সাফল্যের স্থিতি প্রদান করে।

জাভা

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
}

পিএইচপি

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 অনুরোধের জন্য একটি শিরোনাম রয়েছে:

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 সাফল্যের স্থিতি প্রদান করে।

জাভা

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
}

পিএইচপি

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
}