মিডিয়া শেয়ার করুন

আপনার অ্যাপের মাধ্যমে তৈরি করা অ্যালবাম ব্যবহারকারীদের মধ্যে শেয়ার করা যেতে পারে, যেখানে ব্যবহারকারীদের অ্যালবামে কমেন্ট করার বা তাদের নিজস্ব মিডিয়া আইটেম কন্ট্রিবিউট করার অনুমতি দেওয়ার বিকল্প থাকে।

Google Photos Library API-এর মাধ্যমে অ্যালবাম শেয়ার করতে, আপনার অ্যাপকে নিম্নলিখিত কাজগুলি করতে হবে:

  1. ব্যবহারকারীর হয়ে অ্যালবাম তৈরি করা।
  2. সেই অ্যালবাম শেয়ার করার জন্য সেট করুন।

প্রয়োজনীয় যাচাইকরণের স্কোপ

কন্টেন্ট শেয়ার করার জন্য, আপনার অ্যাপকে অবশ্যই photoslibrary.sharing অনুমোদনের স্কোপ-এর জন্য অনুরোধ করতে হবে।

অ্যালবাম শেয়ার করা

অ্যালবাম শেয়ার করার আগে, নিম্নলিখিত বিষয়গুলি বিবেচনা করুন:

  • আপনার অ্যাপ শুধুমাত্র নিজের তৈরি করা অ্যালবাম শেয়ার করতে পারবে। Google Photos সহ অন্যান্য অ্যাপের মাধ্যমে তৈরি করা অ্যালবাম, আপনার অ্যাপের মাধ্যমে শেয়ার করা যাবে না।
  • আপনার অ্যাপ Library API-এর মাধ্যমে কোনও অ্যালবাম শেয়ার করলে, একটি শেয়ার করার উপযুক্ত URL জেনারেট হয় যা ব্যবহার করে যেকেউ অ্যালবামটি অ্যাক্সেস করতে পারবেন।
  • API-এর মাধ্যমে শেয়ার করা অ্যালবামের ক্ষেত্রে, অ্যালবামের মালিক Google Photos অ্যাপে লিঙ্ক শেয়ারিং বন্ধ করতে বা অ্যালবামটি আনশেয়ার করতে পারেন, যা আপনার অ্যাপকে এতে নতুন ব্যবহারকারীদের যোগ করা থেকে বিরত রাখতে পারে।

অ্যালবাম শেয়ার করতে:

  1. UX নির্দেশিকা অনুসরণ করুন এবং শেয়ার করা অ্যালবাম তৈরি করার জন্য ব্যবহারকারীর থেকে স্পষ্ট সম্মতি নিন।
  2. অ্যালবাম তৈরি করুন, এবং এর albumId রেকর্ড করুন। আপনি যদি আগেই অ্যালবাম তৈরি করে থাকেন, তাহলে ব্যবহারকারীর অ্যালবাম তালিকাভুক্ত করে এটির albumId ফিরিয়ে আনতে পারবেন।
  3. আপনি যে শেয়ার করার বিকল্প সেট করতে চান, তার সাথে প্রাসঙ্গিক albumId ব্যবহার করে albums.share কল করুন।
  4. উত্তরে shareToken ভ্যালু রেকর্ড করুন। শেয়ার টোকেন হল শেয়ার করা অ্যালবামের একটি শনাক্তকারী যা বিভিন্ন ব্যবহারকারীর অ্যাকাউন্ট জুড়ে ব্যবহার করা যেতে পারে।
  5. অন্য কোনও ব্যবহারকারী এখন আপনার অ্যাপের মাধ্যমে যাচাইকরণ করতে পারবেন, তারপর shareToken ব্যবহার করে শেয়ার করা অ্যালবামে যোগ দিতে, ছেড়ে যেতে বা বিবরণ ফিরিয়ে আনতে পারবেন।

শেয়ার করার বিকল্প

sharedAlbumOptions প্যারামিটার ব্যবহার করে অ্যালবাম শেয়ার করার সময় নিম্নলিখিত বিকল্পগুলি সেট করা যেতে পারে। বিকল্পগুলি স্পষ্টভাবে সেট করা না থাকলে, ডিফল্ট মান ব্যবহার করা হয়।

প্রপার্টি ডিফল্ট মান বিবরণ
isCollaborative false অন্যান্য Google Photos ব্যবহারকারী শেয়ার করা অ্যালবামে কন্টেন্ট যোগ করতে পারবেন কিনা তা সেট করে।
isCommentable false অন্য Google Photos ব্যবহারকারীরা শেয়ার করা অ্যালবামে কমেন্ট করতে পারবেন কিনা তা সেট করে।

অনুরোধের উদাহরণ

নিম্নলিখিত অনুরোধটি বিকল্প সহ albums.share কল করে একটি অ্যালবাম শেয়ার করে। উত্তরে একটি shareInfo প্রপার্টি ফেরত দেওয়া হয় যা অ্যালবামের শেয়ারিং প্রপার্টি বর্ণনা করে।

বিশ্রাম

অ্যালবাম শেয়ার করার জন্য POST অনুরোধের হেডার এখানে দেওয়া হল:

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

অনুরোধের বডিতে, শেয়ার করার বিকল্প নির্দিষ্ট করুন।

{
  "sharedAlbumOptions": {
    "isCollaborative": "true",
    "isCommentable": "true"
  }
}

এই অনুরোধের ফলে নিম্নলিখিত উত্তর পাওয়া যায়:

{
  "shareInfo": {
    "sharedAlbumOptions": {
      "isCollaborative": "true",
      "isCommentable": "true"
    },
    "shareableUrl": "shareable-url",
    "shareToken": "share-token",
    "isJoinable": "true-if-users-can-join-album",
    "isJoined": "true-if-user-is-joined-to-album",
    "isOwned": "true-if-user-owns-album"
  }
}

Java

try {

  SharedAlbumOptions options =
          // Set the options for the album you want to share
          SharedAlbumOptions.newBuilder()
          .setIsCollaborative(true)
          .setIsCommentable(true)
          .build();
  ShareAlbumResponse response = photosLibraryClient.shareAlbum(albumId, options);

  // The response contains the shareInfo object, a url, and a token for sharing
  ShareInfo info = response.getShareInfo();
  // Link to the shared album
  String url = info.getShareableUrl();
  String shareToken = info
  // The share token which other users of your app can use to join the album you shared
      .getShareToken();
  SharedAlbumOptions sharedOptions = info
      // The options set when sharing this album
      .getSharedAlbumOptions();

} catch (ApiException e) {
  // Handle error
}

PHP

// Set the options for the album you want to share
$options = new SharedAlbumOptions();
$options->setIsCollaborative(true);
$options->setIsCommentable(true);
try {
    $response = $photosLibraryClient->shareAlbum($albumId, ['sharedAlbumOptions' => $options]);
    // The response contains the shareInfo object, a url, and a token for sharing
    $shareInfo = $response->getShareInfo();
    // Link to the shared album
    $url = $shareInfo->getShareableUrl();
    // The share token which other users of your app can use to join the album you shared
    $shareToken = $shareInfo->getShareToken();
    // The options set when sharing this album
    $sharedOptions = $shareInfo->getSharedAlbumOptions();
} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}

শেয়ার করা অ্যালবামের প্রপার্টি

আপনার অ্যাপের মাধ্যমে তৈরি ও শেয়ার করা অ্যালবামের ক্ষেত্রে, যেসব উত্তর album ফিরিয়ে দেয় সেগুলিতে অতিরিক্ত প্রপার্টি, shareInfo অন্তর্ভুক্ত থাকে। অ্যালবাম শেয়ার, তালিকাভুক্ত বা পুনরুদ্ধার করার সময় এই প্রপার্টি রিটার্ন করা হয়।

নিম্নলিখিত সারণীতে shareInfo প্রপার্টি তালিকাভুক্ত করা হয়েছে:

প্রপার্টি
sharedAlbumOptions কোনও ব্যক্তি শেয়ার করা অ্যালবামে মিডিয়া আইটেম যোগ করতে বা কমেন্ট করতে পারবেন কিনা তা বর্ণনা করার বিকল্প।
shareableUrl

শেয়ার করা Google Photos অ্যালবামের লিঙ্ক। লিঙ্ক আছে এমন যে কেউ অ্যালবামের কন্টেন্ট দেখতে পারবেন, তাই এটি সাবধানে ব্যবহার করা উচিত।

অ্যালবামে লিঙ্ক শেয়ারিং চালু করা থাকলে, তবেই shareableUrl ফিল্ডটি ফেরত পাঠানো হয়। কোনও ব্যবহারকারী যদি আগে থেকেই এমন কোনও অ্যালবামে যোগ দিয়ে থাকেন যেটি লিঙ্ক-শেয়ার করা নয়, তাহলে তিনি এর পরিবর্তে অ্যালবামটি অ্যাক্সেস করতে productUrl ব্যবহার করতে পারবেন।

মালিক Google Photos অ্যাপে লিঙ্ক শেয়ারিং বন্ধ করে দিলে অথবা অ্যালবাম শেয়ার করা বন্ধ করে দিলে, shareableUrl বাতিল হয়ে যায়।

shareToken

একটি টোকেন যা ব্যবহার করা হয় যোগ দিতে, ছেড়ে যেতে, অথবা বিবরণ উদ্ধার করতে, এমন একজন ব্যবহারকারীর হয়ে যিনি শেয়ার করা অ্যালবামের মালিক নন।

মালিক Google Photos অ্যাপে লিঙ্ক শেয়ারিং বন্ধ করে দিলে অথবা অ্যালবাম শেয়ার করা বন্ধ করে দিলে, shareToken বাতিল হয়ে যায়।

isJoinable True যদি ব্যবহারকারীরা অ্যালবামে যোগ দিতে পারেন।
isJoined ব্যবহারকারী অ্যালবামে যোগ দিলে True। অ্যালবামের মালিকের ক্ষেত্রে এটি সবসময় প্রযোজ্য।
isOwned ব্যবহারকারী অ্যালবামের মালিক হলে True।

অ্যালবাম শেয়ার করা বন্ধ করা হচ্ছে

আপনার অ্যাপ আগে শেয়ার করেছে এমন কোনও অ্যালবাম শেয়ার করা বন্ধ করতে, অ্যালবামের albumId ব্যবহার করে albums.unshare কল করুন।

অ্যালবামটি আর শেয়ার না করার পাশাপাশি, নিম্নলিখিত বিষয়গুলি ঘটবে:

  • মালিক নন এমন সব ব্যক্তি অ্যালবামের অ্যাক্সেস হারাবেন। এর মধ্যে সেইসব ব্যক্তিও অন্তর্ভুক্ত যাদের সাথে Google Photos অ্যাপের মাধ্যমে নির্দিষ্টভাবে শেয়ার করা অ্যালবাম রয়েছে।
  • মালিক নন এমন ব্যক্তির যোগ করা সব কন্টেন্ট অ্যালবাম থেকে সরিয়ে দেওয়া হবে।
  • কোনও ব্যবহারকারী আগে থেকে তার লাইব্রেরিতে অ্যালবামের কন্টেন্ট যোগ করে থাকলে, কন্টেন্ট তার লাইব্রেরিতে থেকে যাবে।
  • অ্যালবামের শেয়ার টোকেন ও শেয়ার করার URL বাতিল হয়ে যাবে।

অনুরোধের উদাহরণ

বিশ্রাম

অ্যালবাম শেয়ার করা বন্ধ করার জন্য POST অনুরোধের হেডার এখানে দেওয়া হল:

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

অনুরোধের বডি ফাঁকা থাকতে হবে।

অনুরোধটি সফল হলে, এটি HTTP সফল স্ট্যাটাস কোড সহ একটি খালি উত্তর প্রদান করে। অনুরোধ সফল না হলে, এটি একটি ত্রুটি মেসেজ সহ HTTP ত্রুটি স্ট্যাটাস কোড ফেরত দেয়।

Java

try {
  // If this call is not successful, an exception is raised
  photosLibraryClient.unshareAlbum(albumId);
} catch (ApiException e) {
  // Handle error
}

PHP

try {
    // Mark the album as private and no longer shared
    // If this call is not successful, an exception is raised
    $photosLibraryClient->unshareAlbum($albumId);
} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}

শেয়ার করা অ্যালবাম ও শেয়ার টোকেন ফিরিয়ে আনা হচ্ছে

আপনার অ্যাপ কোনও অ্যালবাম শেয়ার করলে, শেয়ার টোকেন সহ শেয়ার করা অ্যালবামের বিবরণ ফেরত দেওয়া হয়। এছাড়াও, আপনি পরে নিম্নলিখিত উপায়ে সেইসব বিবরণ ফিরে পেতে পারেন।

বর্তমানে আপনার অ্যাপের সাথে কানেক্ট করা ব্যবহারকারী যদি মালিক হন বা অ্যালবামে যোগ দিয়ে থাকেন:

  • প্রাসঙ্গিক albumId ব্যবহার করে albums.get-এর সাথে।
  • albums.list-এর সাথে, যদি অ্যালবামে মিডিয়া আইটেম থাকে।
  • sharedAlbums.list-এর মাধ্যমে, যা ব্যবহারকারীর যোগ দেওয়া বা মালিকানাধীন সব শেয়ার করা অ্যালবাম ফিরিয়ে দেয়। আপনার অ্যাপের তৈরি করা অ্যালবাম শুধুমাত্র ফিরিয়ে আনতে, excludeNonAppCreatedData প্যারামিটার ব্যবহার করুন।
  • sharedAlbums.get-এর সাথে শেয়ার টোকেন ব্যবহার করে।

আপনার অ্যাপের সাথে বর্তমানে কানেক্ট করা ব্যবহারকারী যদি অ্যালবামে যোগ না দিয়ে থাকেন, তাহলে আপনি সঠিক শেয়ার টোকেন ব্যবহার করে sharedAlbums.get-এর মাধ্যমে শেয়ার করা অ্যালবামের বিবরণ উদ্ধার করতে পারবেন।

অনুরোধের উদাহরণ

বিশ্রাম

shareToken-এর মাধ্যমে অ্যালবাম পাওয়ার অনুরোধ এখানে দেওয়া হল:

GET https://photoslibrary.googleapis.com/v1/sharedAlbums/share-token

অনুরোধটি সফল হলে, এটি শেয়ার করা album বিবরণ ফিরিয়ে দেয়।

Java

try {
  // Get a shared album from its share token
  Album sharedAlbum = photosLibraryClient.getSharedAlbum(shareToken);

  String id = sharedAlbum.getId();
  String title = sharedAlbum.getTitle();
  // ...

} catch (ApiException e) {
  // Handle error
}

PHP

try {
    // Get the album from a share token
    $album = $photosLibraryClient->getSharedAlbum($shareToken);

    // Get some properties of an album
    $productUrl = $album->getProductUrl();
    $title = $album->getTitle();

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

শেয়ার করা অ্যালবামে যোগ দেওয়া

আপনার অ্যাপ, অ্যালবামের শেয়ার টোকেন ব্যবহার করে কোনও ব্যবহারকারীর হয়ে শেয়ার করা অ্যালবামে যোগ দিতে পারে। এটি করতে, নিম্নলিখিত শর্তগুলি পূরণ করতে হবে:

  • আপনার অ্যাপ অ্যালবামটি তৈরি ও শেয়ার করেছে।
  • আপনি যে ব্যবহারকারীকে অ্যালবামে যোগ করতে চান তিনি এটির মালিক নন। অর্থাৎ, অ্যালবামের shareInfo-এ isOwned ফিল্ডটি মিথ্যা।
  • শেয়ার টোকেনটি সঠিক।
  • অ্যালবামের shareInfo-এ isJoinable ফিল্ডটি সত্য।

বিশ্রাম

শেয়ার করা অ্যালবামে যোগ দেওয়ার জন্য POST অনুরোধের হেডার এখানে দেওয়া হল:

POST https://photoslibrary.googleapis.com/v1/sharedAlbums:join
Content-type: application/json
Authorization: Bearer oauth2-token

অনুরোধের প্রধান অংশে, shareToken উল্লেখ করুন।

{
  "shareToken": "share-token"
}

পোস্ট রিকোয়েস্ট শেয়ার করা album ফিরিয়ে দেয় ব্যবহারকারীর হয়ে আপনার অ্যাপ যোগ দিয়েছে।

Java

try {
  // Join the shared album using the share token obtained when sharing the album
  // If this call is not successful, an exception is raised
  JoinSharedAlbumResponse response = photosLibraryClient.joinSharedAlbum(shareToken);
  Album joinedAlbum = response.getAlbum();
} catch (ApiException e) {
  // Handle error
}

PHP

try {
    $response = $photosLibraryClient->joinSharedAlbum($shareToken);
    // Join the shared album using the share token obtained when sharing the album
    // If this call is not successful, an exception is raised
    $joinedAlbum = $response->getAlbum();
} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}

শেয়ার করা অ্যালবাম থেকে বেরিয়ে আসা

আপনার অ্যাপ, অ্যালবামের শেয়ার টোকেন ব্যবহার করে, কোনও ব্যবহারকারীর হয়ে শেয়ার করা অ্যালবাম থেকে বেরিয়ে আসতে পারে। এটি করতে, নিম্নলিখিত শর্তগুলি পূরণ করতে হবে:

  • আপনার অ্যাপ অ্যালবাম তৈরি ও শেয়ার করেছে।
  • ব্যবহারকারী বর্তমানে অ্যালবামে যোগ দিয়েছেন। অর্থাৎ, অ্যালবামের shareInfo-এ isJoined ফিল্ডটি সত্য।
  • আপনার অ্যাপের সাথে কানেক্ট করা ব্যবহারকারী অ্যালবামের মালিক নন। অর্থাৎ, অ্যালবামের shareInfo-এ isOwned ফিল্ডটি মিথ্যা।

বিশ্রাম

শেয়ার করা অ্যালবাম থেকে বেরিয়ে আসার জন্য এখানে একটি POST অনুরোধ হেডার দেওয়া হল:

POST https://photoslibrary.googleapis.com/v1/sharedAlbums:leave
Content-type: application/json
Authorization: Bearer oauth2-token

অনুরোধের প্রধান অংশে, shareToken উল্লেখ করুন।

{
  "shareToken": "share-token"
}

অনুরোধটি সফল হলে, এটি HTTP সফল স্ট্যাটাস কোড সহ একটি খালি উত্তর প্রদান করে। অনুরোধ সফল না হলে, এটি একটি ত্রুটি মেসেজ সহ HTTP ত্রুটি স্ট্যাটাস কোড ফেরত দেয়।

Java

try {
  // Leave a shared album using its share token
  // If this call is not successful, an exception is raised
  photosLibraryClient.leaveSharedAlbum(shareToken);
} catch (ApiException e) {
  // Handle error
}

PHP

try {
    // Leave the shared album using the share token obtained when sharing the album
    // If this call is not successful, an exception is raised
    $photosLibraryClient->leaveSharedAlbum($shareToken);
} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}

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

আপনার অ্যাপের মাধ্যমে শেয়ার করা অ্যালবামের অন্তর্গত মিডিয়া আইটেমে একটি অতিরিক্ত প্রপার্টি থাকে, contributorInfo। শেয়ার করা অ্যালবামের কন্টেন্ট তালিকাভুক্ত করার সময় শুধুমাত্র এই প্রপার্টি অন্তর্ভুক্ত করা হয়।

contributorInfo প্রপার্টিতে সেই ব্যবহারকারীর নাম থাকে যিনি অ্যালবামে মিডিয়া আইটেম যোগ করেছেন এবং তার প্রোফাইল ছবির বেস URL থাকে।

একটা উদাহরণ দেওয়া হল:

{
  "id: "media-item-id",
  ...,
  "mediaMetadata": {
    ...
  }
  "contributorInfo": {
    "profilePictureBaseUrl": "profile-picture-base-url_use-only-with-parameters",
    "displayName": "name-of-user"
  }
}