মিডিয়া আইটেম তালিকা এবং পুনরুদ্ধার

একবার একজন ব্যবহারকারী পিকার API ব্যবহার করে মিডিয়া আইটেম নির্বাচন করলে, আপনি তাদের সম্পর্কে তথ্য পুনরুদ্ধার করতে এবং তাদের সামগ্রী অ্যাক্সেস করতে পারেন। এই নির্দেশিকা মিডিয়া আইটেমগুলি তালিকাভুক্ত এবং পুনরুদ্ধারের প্রক্রিয়ার রূপরেখা দেয়৷

আপনি শুরু করার আগে

  • প্রবাহটি বুঝুন: সম্পূর্ণ ফটো নির্বাচন প্রক্রিয়ার একটি ওভারভিউয়ের জন্য পিকার API দিয়ে শুরু করুন ।
  • সম্পূর্ণ মিডিয়া আইটেম নির্বাচন: নিশ্চিত করুন যে ব্যবহারকারী সফলভাবে তাদের সেশন থেকে মিডিয়া আইটেম নির্বাচন করেছেন। আরো বিস্তারিত জানার জন্য সেশনের গাইড পড়ুন।
  • প্রয়োজনীয় অনুমোদনের সুযোগগুলি পর্যালোচনা করুন : সেশনগুলির সাথে কাজ করার জন্য photospicker.mediaitems.readonly সুযোগ প্রয়োজন৷ স্কোপ সম্পর্কে আরও তথ্যের জন্য, অনুমোদনের সুযোগগুলি দেখুন।

বাছাই করা মিডিয়া আইটেম তালিকা

  1. mediaItems.list এন্ডপয়েন্ট ব্যবহার করুন: https://photospicker.googleapis.com/v1/mediaItems-এ একটি GET অনুরোধ করুন, একটি ক্যোয়ারী প্যারামিটার হিসাবে sessionId প্রদান করুন।

  2. পেজিনেশন পরিচালনা করুন (যদি প্রয়োজন হয়):

    ব্যবহারকারী যদি বিপুল সংখ্যক আইটেম নির্বাচন করেন, তাহলে প্রতিক্রিয়াটি পৃষ্ঠাযুক্ত হতে পারে। ফলাফলের পরবর্তী পৃষ্ঠাগুলি পুনরুদ্ধার করতে প্রতিক্রিয়াতে nextPageToken ব্যবহার করুন।

  3. মিডিয়া আইটেমগুলি প্রক্রিয়া করুন: প্রতিক্রিয়াতে PickedMediaItem অবজেক্টের একটি অ্যারে থাকবে, প্রতিটি একটি নির্বাচিত মিডিয়া আইটেম প্রতিনিধিত্ব করে। এই বস্তুর মধ্যে অপরিহার্য বিবরণ অন্তর্ভুক্ত যেমন:

    • id : মিডিয়া আইটেমের জন্য অনন্য শনাক্তকারী।
    • baseUrl : ভিত্তি URL যেখান থেকে আপনি বিভিন্ন রেজোলিউশনে মিডিয়া আইটেমের বিষয়বস্তু অ্যাক্সেস করতে URL তৈরি করতে পারেন।
    • mimeType : মিডিয়া আইটেমের MIME প্রকার (যেমন, image/jpeg, video/mp4)।

বাছাই করা মিডিয়া আইটেম পুনরুদ্ধার করুন

আপনার অনুরোধগুলি অনুমোদন করার জন্য https://www.googleapis.com/auth/photospicker.mediaitems.readonly সুযোগ সহ আপনার কাছে একটি বৈধ OAuth 2.0 অ্যাক্সেস টোকেন রয়েছে তা নিশ্চিত করুন৷

  • কন্টেন্ট ইউআরএল তৈরি করুন: PickedMediaItem অবজেক্ট থেকে baseUrl ব্যবহার করুন। বেসইউআরএলে রেজোলিউশন বা ফাইল ফরম্যাট যোগ করুন। আরও বিশদ বিবরণের জন্য বেস ইউআরএল-এর বিভাগটি দেখুন।

  • বিষয়বস্তু আনুন: মিডিয়া আইটেমের ভিত্তি URL-এ একটি GET অনুরোধ করুন৷ প্রতিক্রিয়া মিডিয়া আইটেমের বাইট ধারণ করবে (ছবি বা ভিডিও)। বিভিন্ন বেসইউআরএল বিকল্প উপলব্ধ রয়েছে।

বেস ইউআরএল

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

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

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

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

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

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

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

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

ছবির ভিত্তি URL

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

প্যারামিটার
w , h

বর্ণনা

প্রস্থ, w এবং উচ্চতা, h প্যারামিটার।

একটি ইমেজ মিডিয়া আইটেম অ্যাক্সেস করতে, যেমন একটি ভিডিওর জন্য একটি ফটো বা একটি থাম্বনেইল, আপনাকে অবশ্যই আপনার অ্যাপ্লিকেশনে প্রদর্শন করার পরিকল্পনা করা মাত্রাগুলি নির্দিষ্ট করতে হবে (যাতে আকৃতির অনুপাত সংরক্ষণ করার সময় ছবিটি এই মাত্রাগুলিতে স্কেল করা যেতে পারে)৷ এটি করার জন্য, উদাহরণগুলিতে দেখানো হিসাবে আপনার প্রয়োজনীয় মাত্রাগুলির সাথে বেস ইউআরএল সংযুক্ত করুন৷

উদাহরণ:

base-url=wmax-width-hmax-height

এখানে 2048 পিক্সেলের চেয়ে বেশি চওড়া এবং 1024 পিক্সেলের বেশি লম্বা নয় এমন একটি মিডিয়া আইটেম প্রদর্শনের একটি উদাহরণ রয়েছে:

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

বর্ণনা

ফসল, c প্যারামিটার।

আপনি যদি নির্দিষ্ট প্রস্থ এবং উচ্চতার মাত্রায় ইমেজটি ক্রপ করতে চান, তাহলে বাধ্যতামূলক w এবং h প্যারামিটারের সাথে ঐচ্ছিক -c প্যারামিটারের সাথে বেস ইউআরএল সংযুক্ত করুন।

আকার (পিক্সেলে) পরিসরে হওয়া উচিত [1, 16383]। যদি হয় ছবির প্রস্থ বা উচ্চতা, অনুরোধ করা মাপ ছাড়িয়ে যায়, ছবি ছোট করে ছোট করা হয় (আকৃতির অনুপাত বজায় রেখে)।

উদাহরণ:

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

এই উদাহরণে, অ্যাপ্লিকেশনটি একটি মিডিয়া আইটেম প্রদর্শন করে যা ঠিক 256 পিক্সেল চওড়া এবং 256 পিক্সেল উচ্চ, যেমন থাম্বনেইল:

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

বর্ণনা

ডাউনলোড, d প্যারামিটার।

আপনি যদি অবস্থানের মেটাডেটা ব্যতীত সমস্ত Exif মেটাডেটা ধরে রেখে ইমেজ ডাউনলোড করতে চান, তাহলে d প্যারামিটারের সাথে বেস ইউআরএল সংযুক্ত করুন।

উদাহরণ:

base-url=d

এই উদাহরণে, অ্যাপ্লিকেশনটি অবস্থানের মেটাডেটা ব্যতীত সমস্ত মেটাডেটা সহ একটি চিত্র ডাউনলোড করে: 

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

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

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

প্যারামিটার
dv

বর্ণনা

একটি ভিডিও mediaItem বাইট অ্যাক্সেস করতে, ডাউনলোড ভিডিও, dv প্যারামিটারের সাথে baseUrl সংযুক্ত করুন।

ডিভি প্যারামিটারটি মূল ভিডিওর একটি উচ্চ মানের, ট্রান্সকোডেড সংস্করণের জন্য অনুরোধ করে। প্যারামিটারটি w এবং h প্যারামিটারের সাথে সামঞ্জস্যপূর্ণ নয়।

ভিডিও ডাউনলোডের জন্য বেস URL গুলি বাইট ফেরত পেতে কয়েক সেকেন্ড পর্যন্ত সময় নিতে পারে৷

এই প্যারামিটারটি ব্যবহার করার আগে, মিডিয়া আইটেমগুলির mediaMetadata.status ক্ষেত্রটি READY কিনা তা পরীক্ষা করুন। অন্যথায়, আপনার মিডিয়া আইটেম প্রক্রিয়াকরণ শেষ না হলে আপনি একটি ত্রুটি পেতে পারেন।

উদাহরণ:

base-url=dv

নিম্নলিখিত উদাহরণ আপনাকে দেখায় কিভাবে একটি ভিডিওর বাইট ডাউনলোড করতে হয়:

https://lh3.googleusercontent.com/p/AF....BsdZ=dv
w , h , c , এবং d

বর্ণনা

ভিডিওর থাম্বনেইল অ্যাক্সেস করতে ছবির বেস ইউআরএল প্যারামিটারের যেকোনো একটি ব্যবহার করুন।

ডিফল্টরূপে, সমস্ত ভিডিও থাম্বনেইলে একটি প্লেব্যাক বোতামের একটি ওভারলে অন্তর্ভুক্ত থাকে। এই ওভারলে অপসারণ করতে -কোন প্যারামিটার দেখুন।

উদাহরণ:

উদাহরণের জন্য ইমেজ বেস ইউআরএল টেবিল পড়ুন।

no

বর্ণনা

থাম্বনেইল ওভারলে অপসারণ করুন, কোনো প্যারামিটার no ।

আপনি যদি কোনো প্লেব্যাক বোতামের ওভারলে ছাড়াই কোনো ভিডিওর থাম্বনেল পুনরুদ্ধার করতে চান, তাহলে কোনো প্যারামিটার ছাড়াই বেস ইউআরএল সংযুক্ত করুন।

নো প্যারামিটার অবশ্যই অন্তত একটি ছবির বেস URL প্যারামিটারের সাথে ব্যবহার করা উচিত।

উদাহরণ:

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

নিম্নলিখিত উদাহরণটি একটি ভিডিও থাম্বনেইল প্রদর্শন করে যা ঠিক 1280 পিক্সেল চওড়া বাই 720 পিক্সেল উচ্চ এবং একটি প্লেব্যাক বোতাম ওভারলে অন্তর্ভুক্ত করে না: 

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

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

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

প্যারামিটার
dv

বর্ণনা

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

w , h , c , এবং d

বর্ণনা

একটি মোশন ফটো মিডিয়া আইটেমের ফটো উপাদান পুনরুদ্ধার করতে, ইমেজ বেস URL- এর বিন্যাসটি ব্যবহার করুন।