এনরিচমেন্ট যোগ করুন

সমৃদ্ধকরণ আপনার অ্যাপ্লিকেশনকে Google Photos-এর একটি অ্যালবামের মধ্যে ফটোগুলির গঠন এবং উপস্থাপনা নিয়ন্ত্রণ করতে দেয়। এগুলি আপনাকে টেক্সট বা লোকেশন অ্যানোটেশনের মাধ্যমে ব্যবহারকারীকে অতিরিক্ত প্রসঙ্গ উপস্থাপন করতে এবং একসাথে একটি গল্প বলে এমন ছবি অর্ডার/গ্রুপ করতে দেয়।

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

এনরিচমেন্ট যোগ করতে, নিম্নলিখিত স্কোপের মধ্যে অন্তত একটি প্রয়োজন:

  • photoslibrary.appendonly
  • photoslibrary.library
  • photoslibrary.sharing

প্রতিটি স্কোপের জন্য, enrichAlbum কল শুধুমাত্র অ্যাপের মাধ্যমে তৈরি করা অ্যালবামের মধ্যেই সীমাবদ্ধ।

.sharing স্কোপ ব্যবহার করার সময়, enrichAlbum শুধুমাত্র সেইসব পরিস্থিতিতেই সীমাবদ্ধ থাকে যেখানে ডেভেলপার শেয়ার করা অ্যালবামের মালিকের হয়ে কাজ করছেন।

এনরিচমেন্টের ধরন

Google Photos-এ অ্যালবামে তিন ধরনের এনরিচমেন্ট কাজ করে: টেক্সট, লোকেশন ও ম্যাপ।

টেক্সট এনরিচমেন্ট

টেক্সট এনরিচমেন্ট হল একটি প্লেন টেক্সট স্ট্রিং যা অ্যালবামে অ্যানোটেট করার জন্য যোগ করা যেতে পারে।

Google Photos-এ দেখানো টেক্সট এনরিচমেন্টের স্ক্রিনশট

লোকেশন এনরিচমেন্ট

লোকেশন এনরিচমেন্ট হল একটি মার্কার এবং জায়গার নাম যা কোনও লোকেশন অ্যানোটেট করার জন্য যোগ করা যেতে পারে।

Google Photos-এ দেখানো লোকেশন এনরিচমেন্টের স্ক্রিনশট

ম্যাপ এনরিচমেন্ট

ম্যাপ এনরিচমেন্ট হল নির্দিষ্ট উৎস ও গন্তব্য সহ ম্যাপ যা অ্যালবামে যোগ করা যেতে পারে।

Google Photos-এ দেখানো ম্যাপ এনরিচমেন্টের স্ক্রিনশট

অবস্থান

মিডিয়া আইটেম ও অ্যালবাম এনরিচমেন্ট যোগ করতে, অ্যালবামের পজিশন উল্লেখ করুন। মিডিয়া আইটেমের জন্য অবস্থান ঐচ্ছিক, তবে অ্যালবাম সমৃদ্ধকরণের জন্য অবশ্যই নির্দিষ্ট করতে হবে।

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

অ্যালবামের শুরু

অ্যালবামের শুরুতে অ্যাবসোলিউট পজিশনিং হিসেবে মিডিয়া/এনরিচমেন্ট আইটেম যোগ করা যেতে পারে।

অ্যালবামের শেষ

অ্যালবামের শেষে অ্যাবসোলিউট পজিশনিং হিসেবে মিডিয়া/এনরিচমেন্ট আইটেম যোগ করা যেতে পারে।

মিডিয়া আইটেমের সাপেক্ষে গণনা করা হয়েছে

অ্যালবামে মিডিয়া আইটেমের অবস্থানের পরে শুরু হওয়া মিডিয়া আইটেমের সাথে সম্পর্কিত মিডিয়া/এনরিচমেন্ট আইটেম যোগ করা যেতে পারে।

এনরিচমেন্ট আইটেমের সাথে সম্পর্কিত

অ্যালবামে কোনও এনরিচমেন্ট আইটেমের পরে, এনরিচমেন্ট আইটেমের শুরুর সাপেক্ষে মিডিয়া/এনরিচমেন্ট আইটেম যোগ করা যেতে পারে।

অ্যালবামে এনরিচমেন্ট যোগ করা হচ্ছে

একবারে একটি করে এনরিচমেন্ট যোগ করা হয় এবং অ্যালবামের কোনও একটি পজিশনে যোগ করতে হয়। অ্যালবামে সমৃদ্ধকরণ যোগ করতে, albums.addEnrichment কল করুন।

অনুরোধ সফল হলে, এটি এনরিচমেন্ট আইটেমের id ফিরিয়ে দেয়, যা মিডিয়া আইটেম বা অন্যান্য এনরিচমেন্টের পজিশন ঠিক করতে ব্যবহার করা যেতে পারে।

বিশ্রাম

এখানে একটি POST অনুরোধ দেওয়া হল:

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

অনুরোধের মূল অংশে এনরিচমেন্ট আইটেম ও তার পজিশন থাকে:

{
  "newEnrichmentItem": {
    enrichment-to-be-added
  },
  "albumPosition": {
    position-of-enrichment
}

এখানে একটি নমুনা উত্তর দেওয়া হল:

{
  "enrichmentItem": {
    "id": "enrichment-item-id",
  }
}

Java

try {
  // Create the enrichment using the NewEnrichmentItemFactory helper
  NewEnrichmentItem newEnrichmentItem = NewEnrichmentItemFactory.createTextEnrichment("");

  // Set the position of the enrichment within the album
  AlbumPosition albumPosition = AlbumPositionFactory.createFirstInAlbum();

  // To add an enrichment, specify the album, the enrichment item,
  // and the position in the album where the enrichment is to be added
  AddEnrichmentToAlbumResponse response = photosLibraryClient
      .addEnrichmentToAlbum(albumId, newEnrichmentItem, albumPosition);
  // The response contains an EnrichmentItem
  // whose ID can be used to position media items or other enrichments
  EnrichmentItem enrichmentItem = response.getEnrichmentItem();
  String itemId = enrichmentItem.getId();
} catch (ApiException e) {
  // Handle error
}

PHP

// Create the enrichment item using the PhotosLibraryResourceFactory helper
$newEnrichmentItem = PhotosLibraryResourceFactory::newEnrichmentItemWithText("");
// ...
// Set the position of the enrichment within the album
$position = new AlbumPosition();
// ...
try {
    // To add an enrichment, specify the album, the enrichment item,
    // and the position in the album where the enrichment is to be added
    $response = $photosLibraryClient->addEnrichmentToAlbum($albumId, $newEnrichmentItem, $position);
    // The response contains an EnrichmentItem
    // whose ID can be used to position media items or other enrichments
    $enrichmentItem = $response->getEnrichmentItem();
    $itemId = $enrichmentItem->getId();

} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}

যেসব এনরিচমেন্ট কাজ করে

টেক্সট এনরিচমেন্ট

টেক্সট এনরিচমেন্টে একটি টেক্সট স্ট্রিং (১০০০ অক্ষরের বেশি নয়) থাকে, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

বিশ্রাম

{
  "text": "Text to be shown"
}

Java

// Use the NewEnrichmentItemFactory helper to create a text enrichment item
NewEnrichmentItem newEnrichmentItem =
    NewEnrichmentItemFactory.createTextEnrichment("text to be shown");

PHP

$newEnrichmentItem = PhotosLibraryResourceFactory::newEnrichmentItemWithText("text to be shown");

লোকেশন এনরিচমেন্ট

লোকেশন এনরিচমেন্টে একটি ইচ্ছামতো লোকেশনের নাম এবং অক্ষাংশ ও দ্রাঘিমাংশের অবস্থান থাকে। locationName ৫০০ অক্ষরের মধ্যে সীমিত।

বিশ্রাম

{
  "location": {
    "locationName": "Australia",
    "latlng": {
      "latitude": "-21.197",
      "longitude": "95.821"
    }
  }
}

Java

// Use the NewEnrichmentItemFactory helper to create a location enrichment
// with the name, latitude, and longitude of the location
NewEnrichmentItem newEnrichmentItem =
    NewEnrichmentItemFactory.createLocationEnrichment("Australia", -21.197, 95.821);

PHP

// Create a new location object and set the name, latitude, and longitude of the location
$newLocation = new Location();
$newLocation->setLocationName("Australia");
$newLocation->setLatlng((new LatLng())->setLatitude(-21.197)->setLongitude(95.821));

$newEnrichmentItem = PhotosLibraryResourceFactory::newEnrichmentItemWithLocation($newLocation);

ম্যাপ এনরিচমেন্ট

ম্যাপ এনরিচমেন্টে দুটি লোকেশন দেখানো হয়, যার প্রতিটিতে নাম, অক্ষাংশ ও দ্রাঘিমাংশ থাকে। লোকেশন এনরিচমেন্টের মতোই, শুরু এবং destination-এর মধ্যে locationName ৫০০ অক্ষরের মধ্যে সীমাবদ্ধ।

বিশ্রাম

{
  "origin": {
    "locationName": "Australia",
    "latlng": {
      "latitude": "-21.197",
      "longitude": "95.821"
    }
  },
  "destination": {
    "locationName": "San Francisco",
    "latlng": {
      "latitude": "37.757",
      "longitude": "122.507"
    }
  }
}

Java

// Use the NewEnrichmentItemFactory helper to create a map enrichment item for
// an origin and a destination location
NewEnrichmentItem newEnrichmentItem = NewEnrichmentItemFactory.createMapEnrichment(
    "Australia", -21.197, 95.821, // origin
    "San Francisco", 37.757, 122.507 // destination
);

PHP

// Create two new location objects to create a map enrichment item
// for an origin and a destination location
$locationAustralia = new Location();
$locationAustralia->setLocationName("Australia");
$locationAustralia->setLatlng((new LatLng())->setLatitude(-21.197)->setLongitude(95.821));

$locationSanFrancisco = new Location();
$locationSanFrancisco->setLocationName("San Francisco");
$locationSanFrancisco->setLatlng((new LatLng())->setLatitude(37.757)->setLongitude(122.507));

$newEnrichmentItem =
  PhotosLibraryResourceFactory::newEnrichmentItemWithMap($locationAustralia, $locationSanFrancisco);

পোজিশনিং করা যায়

অ্যালবামের শুরু

FIRST_IN_ALBUM পজিশন বলতে অ্যালবামের শুরুকে বোঝায়। এখানে অবস্থিত আইটেমগুলি ব্যবহারকারীকে প্রথমে দেখানো হয়:

বিশ্রাম

{
  "position": "FIRST_IN_ALBUM",
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createFirstInAlbum();

PHP

$albumPosition = new AlbumPosition();
$albumPosition->setPosition(PositionType::FIRST_IN_ALBUM);

অ্যালবামের শেষ

LAST_IN_ALBUM পজিশনটি অ্যালবামের শেষকে বোঝায়। এখানে থাকা আইটেমগুলি ব্যবহারকারীকে সবার শেষে দেখানো হয়।

বিশ্রাম

{
  "position": "LAST_IN_ALBUM",
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createLastInAlbum();

PHP

$albumPosition = new AlbumPosition();
$albumPosition->setPosition(PositionType::LAST_IN_ALBUM);

মিডিয়া আইটেমের সাপেক্ষে গণনা করা হয়েছে

relativeMediaItem পজিশন উল্লেখ করার অর্থ হল, কোনও মিডিয়া আইটেমের সাপেক্ষে পজিশন। নির্দিষ্ট করা মিডিয়া আইটেমের পরে আইটেমগুলি যোগ করা হয়।

বিশ্রাম

{
  "position": "after-media-item",
  "relativeMediaItemId": "media-item-id"
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createAfterMediaItem(mediaItemId);

PHP

$albumPosition = PhotosLibraryResourceFactory::albumPositionAfterMediaItem($mediaItemId);

এনরিচমেন্ট আইটেমের সাথে সম্পর্কিত

relativeEnrichmentItemId উল্লেখ করার অর্থ হল, এনরিচমেন্ট আইটেমের সাপেক্ষে অবস্থান উল্লেখ করা। নির্দিষ্ট করা এনরিচমেন্ট আইটেমের পরে আইটেমগুলি যোগ করা হয়।

বিশ্রাম

{
  "position": "after-enrichment-item",
  "relativeEnrichmentItemId": "enrichment-item-id"
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createAfterEnrichmentItem(enrichmentItemId);

PHP

$albumPosition = PhotosLibraryResourceFactory::albumPositionAfterEnrichmentItem($enrichmentItemId);

এনরিচমেন্ট পরিবর্তন করা হচ্ছে

বর্তমানে, এনরিচমেন্ট পরিবর্তন করার কোনও উপায় নেই। তবে, একবার এনরিচমেন্ট তৈরি করে অ্যালবামে যোগ করা হয়ে গেলে, ব্যবহারকারী Google Photos অ্যাপের মাধ্যমে এনরিচমেন্ট পরিবর্তন করতে পারবেন।