অ্যাপ-তৈরি মিডিয়া আইটেম অ্যাক্সেস করুন

একটি ফটো লাইব্রেরি বা অ্যালবামের বিষয়বস্তু তালিকাভুক্ত করার জন্য কল করার পরে, ফিরে আসা মিডিয়া আইটেমগুলি সংরক্ষণ করার পরিবর্তে, আপনার অ্যাপ্লিকেশনটি মিডিয়া আইটেমগুলির আইডি সংরক্ষণ করা উচিত৷ কারণ মিডিয়া আইটেমগুলির বিষয়বস্তু পরিবর্তিত হতে পারে এবং একটি নির্দিষ্ট সময়ের পরে, প্রতিক্রিয়াতে অন্তর্ভুক্ত URLগুলির মেয়াদ শেষ হয়ে যায়৷ মিডিয়া আইটেম আইডি অনন্যভাবে একটি মিডিয়া আইটেম সনাক্ত করে, যেমন একটি ফটো বা ব্যবহারকারীর লাইব্রেরির মধ্যে একটি ভিডিও।

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

অ্যাপ-তৈরি মিডিয়া আইটেম অ্যাক্সেস করতে photoslibrary.readonly.appcreateddata সুযোগ প্রয়োজন। স্কোপ সম্পর্কে আরও তথ্যের জন্য, অনুমোদনের সুযোগগুলি দেখুন।

মিডিয়া আইটেম

একটি mediaItem হল মিডিয়ার একটি উপস্থাপনা যেমন একটি ফটো বা ভিডিও যা Google ফটো লাইব্রেরিতে আপলোড করা হয়েছে৷ এটি একটি শীর্ষ-স্তরের বস্তু এবং এর বৈশিষ্ট্যগুলি অন্তর্নিহিত মিডিয়া প্রকারের উপর ভিত্তি করে পৃথক হতে পারে।

নিম্নলিখিত সারণী mediaItem বৈশিষ্ট্য তালিকাভুক্ত করে:

একটি মিডিয়া আইটেম পান

একটি মিডিয়া আইটেম পুনরুদ্ধার করতে, mediaItemId কল করুন। অনুরোধ একটি একক মিডিয়া আইটেম ফেরত.

mediaItem বৈশিষ্ট্য রয়েছে, যেমন আইডি, বিবরণ এবং URL। photo বা video অতিরিক্ত তথ্য ফাইলের মধ্যে থাকা মেটাডেটার উপর ভিত্তি করে। সব সম্পত্তি উপস্থিত নাও হতে পারে.

মিডিয়া আইটেম একটি ভিডিও হলে, ভিডিও ফাইলটি প্রথমে প্রক্রিয়া করা আবশ্যক। mediaItem mediaMetadata ভিতরে একটি status ক্ষেত্র রয়েছে যা ভিডিও ফাইলের প্রক্রিয়াকরণ অবস্থা বর্ণনা করে। একটি নতুন আপলোড করা ফাইল ব্যবহারের জন্য READY হওয়ার আগে, প্রথমে PROCESSING মান সহ videoProcessingStatus প্রদান করে৷ ভিডিওটি প্রক্রিয়া না হওয়া পর্যন্ত একটি ভিডিও মিডিয়া আইটেমের baseUrl উপলব্ধ নয়৷

GET https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id
Content-type: application/json
Authorization: Bearer oauth2-token

{
  "id": "media-item-id",
  "description": "item-description",
  "productUrl": "url-to-open-in-google-photos",
  "baseUrl": "base-url_do-not-use-directly",
  "mimeType": "mime-type-of-media",
  "filename": "item-filename",
  "mediaMetadata": {
    "width": "media-item-width",
    "height": "media-item-height",
    "creationTime": "media-item-creation-time",
    "photo": {
       "cameraMake": "make-of-the-camera",
       "cameraModel": "model-of-the-camera",
       "focalLength": "focal-length-of-the-camera-lens",
       "apertureFNumber": "aperture-f-number-of-the-camera-lens",
       "isoEquivalent": "iso-of-the-camera",
       "exposureTime": "exposure-time-of-the-camera-aperture"
    }
  },
  "contributorInfo": {
    "profilePictureBaseUrl": "profile-picture-base-url_do-not-use-directly",
    "displayName": "name-of-user"
  }
}

{
  "id": "media-item-id",
  "description": "item-description",
  "productUrl": "url-to-open-in-google-photos",
  "baseUrl": "base-url_do-not-use-directly",
  "mimeType": "mime-type-of-media",
  "filename": "item-filename",
  "mediaMetadata": {
    "width": "media-item-width",
    "height": "media-item-height",
    "creationTime": "media-item-creation-time",
    "video": {
     "cameraMake": "make-of-the-camera",
     "cameraModel": "model-of-the-camera",
     "fps": "frame-rate-of-the-video",
     "status": "READY"
    },
  },
  "contributorInfo": {
    "profilePictureBaseUrl": "profile-picture-base-url_do-not-use-directly",
    "displayName": "name-of-user"
  }
}

একাধিক মিডিয়া আইটেম পান

তাদের শনাক্তকারীদের দ্বারা একাধিক মিডিয়া আইটেম পুনরুদ্ধার করতে, mediaItems.batchGet ব্যবহার করে mediaItemId কল করুন৷

অনুরোধটি অনুরোধে সরবরাহ করা মিডিয়া আইটেম শনাক্তকারীর ক্রম অনুসারে MediaItemResults এর একটি তালিকা প্রদান করে। প্রতিটি ফলাফলে একটি MediaItem বা একটি Status থাকে যদি কোনো ত্রুটি থাকে।

আপনি এক কলে সর্বাধিক 50টি মিডিয়া আইটেম অনুরোধ করতে পারেন। মিডিয়া আইটেমগুলির তালিকায় অবশ্যই সদৃশ শনাক্তকারী থাকবে না এবং খালি থাকা যাবে না।

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet?mediaItemIds=media-item-id&mediaItemIds=another-media-item-id&mediaItemIds=incorrect-media-item-id
Content-type: application/json
Authorization: Bearer oauth2-token

{
  "mediaItemResults": [
    {
      "mediaItem": {
        "id": "media-item-id",
        ...
      }
    },
    {
      "mediaItem": {
        "id": "another-media-item-id",
        ...
      }
    },
    {
      "status": {
        "code": 3,
        "message": "Invalid media item ID."
      }
    }
  ]
}

বেস ইউআরএল

Google Photos API-এর বেস ইউআরএলগুলি মিডিয়া আইটেমগুলির কাঁচা বাইটগুলিতে অ্যাক্সেস প্রদান করে, আপনার অ্যাপকে সেগুলি ডাউনলোড বা প্রদর্শন করতে সক্ষম করে৷ অ্যালবাম (লাইব্রেরি API) তালিকাভুক্ত করার সময় বা মিডিয়া আইটেমগুলি (লাইব্রেরি এবং পিকার API উভয়ই) অ্যাক্সেস করার সময় এই URLগুলি প্রতিক্রিয়াগুলিতে অন্তর্ভুক্ত করা হয়। মনে রাখবেন, বেস ইউআরএল সঠিকভাবে কাজ করার জন্য অতিরিক্ত প্যারামিটার প্রয়োজন।

পিকার API এর জন্য:

সমস্ত PickedMediaItem.mediaFile অবজেক্টে একটি baseUrl অন্তর্ভুক্ত থাকে।

বেস ইউআরএলগুলি 60 মিনিটের জন্য সক্রিয় থাকে, তবে ব্যবহারকারী যদি তাদের Google অ্যাকাউন্ট সেটিংসের মাধ্যমে আপনার অ্যাপের অনুমতি প্রত্যাহার করে তবে তাড়াতাড়ি মেয়াদ শেষ হতে পারে।

লাইব্রেরি API এর জন্য:

বেস ইউআরএল 60 মিনিটের জন্য সক্রিয় থাকে।

বিভিন্ন ভিত্তি URL হল:

• baseUrl : সরাসরি একটি ভিডিওর জন্য ফটো, থাম্বনেল অ্যাক্সেস করুন বা ভিডিও বাইট ডাউনলোড করুন।
• coverPhotoBaseUrl : অ্যালবামের জন্য সরাসরি কভার ফটো অ্যাক্সেস করুন৷
• profilePictureBaseUrl : সরাসরি mediaItem মালিকের প্রোফাইল ফটো অ্যাক্সেস করুন।

ছবির ভিত্তি URL

এখানে বিকল্পগুলির তালিকা রয়েছে যা আপনি ইমেজ বেস ইউআরএলগুলির সাথে ব্যবহার করতে পারেন:

base-url=wmax-width-hmax-height

https://lh3.googleusercontent.com/p/AF....VnnY=w2048-h1024

base-url=wmax-width-hmax-height-c

https://lh3.googleusercontent.com/p/AF....VnnY=w256-h256-c

base-url=d

https://lh3.googleusercontent.com/p/Az....XabC=d

ভিডিও বেস ইউআরএল

ভিডিও বেস ইউআরএলগুলির সাথে আপনি ব্যবহার করতে পারেন এমন বিকল্পগুলির তালিকা এখানে রয়েছে:

base-url=dv

https://lh3.googleusercontent.com/p/AF....BsdZ=dv

base-url=wmax-width-hmax-height-no

https://lh3.googleusercontent.com/p/AF....VnnY=w1280-h720-no

মোশন ফটো বেস ইউআরএল

মোশন ফটোতে ফটো এবং ভিডিও উভয় উপাদানই থাকে। আপনি মোশন ফটো baseUrl অনুরোধের জন্য ইমেজ বেস ইউআরএল বা ভিডিও বেস ইউআরএল থেকে প্যারামিটার ব্যবহার করতে পারেন।