সমৃদ্ধি যোগ করুন

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

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

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

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

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

.sharing স্কোপ ব্যবহার করার সময়, enrichAlbum এমন পরিস্থিতিতে সীমাবদ্ধ যেখানে বিকাশকারী শেয়ার করা অ্যালবামের মালিকের পক্ষে কাজ করছেন৷

সমৃদ্ধকরণ প্রকার

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

জাভা

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
}

পিএইচপি

// 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
}

সমর্থিত সমৃদ্ধি

পাঠ্য সমৃদ্ধকরণ

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

বিশ্রাম

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

জাভা

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

পিএইচপি

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

অবস্থান সমৃদ্ধি

অবস্থান সমৃদ্ধি একটি নির্বিচারে অবস্থানের নাম এবং অক্ষাংশ এবং দ্রাঘিমাংশের অবস্থান নিয়ে গঠিত। locationName 500টি অক্ষরের মধ্যে সীমাবদ্ধ৷

বিশ্রাম

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

জাভা

// 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);

পিএইচপি

// 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 500 অক্ষরের মধ্যে সীমাবদ্ধ।

বিশ্রাম

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

জাভা

// 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
);

পিএইচপি

// 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",
}

জাভা

AlbumPosition albumPosition = AlbumPositionFactory.createFirstInAlbum();

পিএইচপি

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

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

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

বিশ্রাম

{
  "position": "LAST_IN_ALBUM",
}

জাভা

AlbumPosition albumPosition = AlbumPositionFactory.createLastInAlbum();

পিএইচপি

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

মিডিয়া আইটেম আপেক্ষিক

অবস্থান relativeMediaItem নির্দিষ্ট করা একটি মিডিয়া আইটেমের সাথে সম্পর্কিত একটি অবস্থানকে বোঝায়। আইটেম নির্দিষ্ট মিডিয়া আইটেম পরে যোগ করা হয়.

বিশ্রাম

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

জাভা

AlbumPosition albumPosition = AlbumPositionFactory.createAfterMediaItem(mediaItemId);

পিএইচপি

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

সমৃদ্ধকরণ আইটেম আপেক্ষিক

একটি relativeEnrichmentItemId নির্দিষ্ট করা একটি সমৃদ্ধকরণ আইটেমের সাথে সম্পর্কিত একটি অবস্থানকে বোঝায়। আইটেমগুলি নির্দিষ্ট সমৃদ্ধকরণ আইটেম পরে যোগ করা হয়.

বিশ্রাম

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

জাভা

AlbumPosition albumPosition = AlbumPositionFactory.createAfterEnrichmentItem(enrichmentItemId);

পিএইচপি

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

পরিমার্জন সমৃদ্ধকরণ

বর্তমানে, সমৃদ্ধকরণ পরিবর্তন করার কোন উপায় নেই। যাইহোক, একবার একটি সমৃদ্ধকরণ তৈরি করা এবং একটি অ্যালবামে যোগ করা হলে, ব্যবহারকারী Google Photos অ্যাপের মাধ্যমে সমৃদ্ধকরণগুলি সংশোধন করতে পারেন।