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

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

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

অ্যালবাম তৈরি করতে photoslibrary.appendonly সুযোগ প্রয়োজন।

অ্যালবাম তৈরির পরে তাদের শিরোনাম বা কভার ফটো পরিবর্তন করার জন্য 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"
}

অ্যালবামের বিবরণ পুনরুদ্ধার করুন

আপনার অ্যাপ দ্বারা তৈরি একটি বিদ্যমান অ্যালবামের বিবরণ পুনরুদ্ধার করতে, albums.get এ কল করুন এবং আপনি যে অ্যালবামটি আনতে চান তার albumId অন্তর্ভুক্ত করুন।

কল একটি অ্যালবাম ফিরে.

বিশ্রাম

এখানে একটি GET অনুরোধের জন্য একটি শিরোনাম রয়েছে:

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

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

একটি অ্যালবামে মিডিয়া আইটেম যোগ করুন

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

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

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

একটি অ্যালবাম থেকে মিডিয়া আইটেম সরান

আপনি 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
}