ভূমিকা: ডেটা পোর্টেবিলিটি API ব্যবহার করে অ্যাপস ডেভেলপ করুন

ডেটা পোর্টেবিলিটি API আপনাকে এমন অ্যাপ্লিকেশন তৈরি করতে দেয় যা Google পরিষেবাগুলি থেকে ডেটার একটি অনুলিপি আপনার অ্যাপ্লিকেশনে সরানোর জন্য ব্যবহারকারীর কাছ থেকে অনুমোদনের অনুরোধ করে। এটি ডেটা পোর্টেবিলিটি সক্ষম করে এবং পরিষেবাগুলি স্যুইচ করার সুবিধা দেয়৷

ব্যবহারকারীরা কীভাবে ডেটা ভাগ করে সে সম্পর্কে আপনি যদি তথ্য খুঁজছেন, তৃতীয় পক্ষের সাথে আপনার ডেটার একটি অনুলিপি ভাগ করুন দেখুন৷

পূর্বশর্ত

আপনার অ্যাপটি প্রকাশ করার আগে, এটি অবশ্যই Google দ্বারা অনুমোদিত হতে হবে।

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

বিকাশকারী কর্মপ্রবাহ

ডেটা পোর্টেবিলিটি API ব্যবহার করে এমন একটি অ্যাপ্লিকেশন তৈরি করতে আপনি এই পদক্ষেপগুলি অনুসরণ করেন৷

1. ব্যবহারকারীর জন্য OAuth সম্মতি প্রবাহ প্রয়োগ করুন। এই উদাহরণে, ব্যবহারকারী YouTube ভিডিও ডেটা অ্যাক্সেস প্রদান করছে।

   1. ব্যবহারকারী YouTube ভিডিও আমদানিতে ক্লিক করে এবং তাদের Google অ্যাকাউন্টে সাইন ইন করে।

   2. অ্যাপটি ব্যবহারকারীকে একটি OAuth সম্মতি URL-এ ফরোয়ার্ড করে। মনে রাখবেন যে এই উদাহরণের URL সরলীকৃত এবং কিছু প্যারামিটার অনুপস্থিত:

      https://accounts.google.com/o/oauth2/v2/auth?scope=https://www.googleapis.com/auth/dataportability.myactivity.youtube

   3. ব্যবহারকারী OAuth সম্মতি স্ক্রিনে Next ক্লিক করে, তাদের ডেটা শেয়ার করতে সম্মত হয় এবং অ্যাকাউন্ট অ্যাক্সেস প্রদান করে।

   4. ব্যবহারকারী নির্বাচন করে কোন ডেটা ভাগ করতে হবে এবং অ্যাপটি কতক্ষণ সেই ডেটা অ্যাক্সেস করতে পারে (তাদের ডেটাতে এক-বার অ্যাক্সেস বা 30 বা 180 দিনের জন্য সময়-ভিত্তিক অ্যাক্সেস ), তারপরে চালিয়ে যান ক্লিক করুন।

      দ্রষ্টব্য : আপনার OAuth টোকেনের মেয়াদ শেষ হওয়ার 90 দিন আগে, ব্যবহারকারীর কাছে আপনার OAuth টোকেনের মেয়াদ শেষ হওয়ার আগে তাদের ডেটাতে আপনার অ্যাক্সেস পুনর্নবীকরণ করার বিকল্প রয়েছে। ব্যবহারকারীর 90 দিনের মধ্যে মেয়াদ শেষ না হলে পুনর্নবীকরণ বোতামটি উপস্থিত হয় না।

      দ্রষ্টব্য : ব্যবহারকারী যদি এককালীন অ্যাক্সেস এবং সময়-ভিত্তিক অ্যাক্সেসের মধ্যে স্যুইচ করতে চান তবে বিদ্যমান অনুদান প্রত্যাহার করার পরে তাদের আবার সম্মতি প্রবাহের মধ্য দিয়ে যেতে হবে। আপনি resetAuthorization() দিয়ে অনুদান প্রত্যাহার করতে পারেন, অথবা ব্যবহারকারী তাদের সংযোগ পৃষ্ঠায় প্রত্যাহার করতে পারেন।

   5. ব্যবহারকারীকে অ্যাপে পুনঃনির্দেশিত করা হয়।

   6. বিকাশকারী ব্যবহারকারীর জন্য একটি OAuth টোকেন পায়।

2. আপনার অ্যাপটি একটি সংযুক্ত OAuth টোকেন সহ InitiatePortabilityArchive(resources = ["myactivity.youtube"]) কল করে যাতে এই OAuth সুযোগ রয়েছে:

   https://www.googleapis.com/auth/dataportability.myactivity.youtube

   এই কলটি ডেটা সংরক্ষণাগার তৈরির প্রক্রিয়া শুরু করে এবং একটি কাজের আইডি দিয়ে প্রতিক্রিয়া জানায় এবং ব্যবহারকারী এক-বার বা সময়-ভিত্তিক অ্যাক্সেস মঞ্জুর করে কিনা।

   দ্রষ্টব্য : এককালীন অ্যাক্সেস মানে প্রতি সুযোগে একটি রপ্তানি। যদি ব্যবহারকারী একাধিক সুযোগ প্রদান করে, আপনি টোকেন দ্বারা অনুমোদিত প্রতিটি সংস্থানের জন্য পৃথক কাজ তৈরি করতে বেছে নিতে পারেন।

3. আপনার অ্যাপটি একটি সংযুক্ত OAuth টোকেন সহ GetPortabilityArchiveState(job_id) কল করে যাতে এই OAuth সুযোগ রয়েছে:

   https://www.googleapis.com/auth/dataportability.myactivity.youtube

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

4. স্বাক্ষরিত URL ব্যবহার করে ডেটা সংরক্ষণাগার ডাউনলোড করুন।

5. ব্যবহারকারী যদি এককালীন অ্যাক্সেস মঞ্জুর করে , তাহলে আপনি নিঃশেষিত সংস্থানগুলি পুনরায় সেট করতে এবং সমস্ত OAuth সম্মতিগুলি সরাতে একটি সংযুক্ত OAuth টোকেন সহ ResetAuthorization() কল করুন৷

6. ব্যবহারকারী যদি সময়-ভিত্তিক অ্যাক্সেস মঞ্জুর করে , তাহলে সম্মতির মেয়াদ শেষ না হওয়া পর্যন্ত আপনি প্রতি 24 ঘন্টা সম্পদ রপ্তানি করতে পারেন।

ডেটা পোর্টেবিলিটি API পদ্ধতিগুলি ব্যবহার করার বিষয়ে আরও তথ্যের জন্য, কল ডেটা পোর্টেবিলিটি API পদ্ধতিগুলি দেখুন।

ব্যবহারকারীরা কীভাবে ডেটা পোর্টেবিলিটি API অ্যাপের সাথে ইন্টারঅ্যাক্ট করে

এই চিত্রটি দেখায় কিভাবে ব্যবহারকারীরা ডেটা পোর্টেবিলিটি API এর সাথে একত্রিত একটি অ্যাপের সাথে ইন্টারঅ্যাক্ট করে।

1. প্রথমত, ব্যবহারকারীকে তাদের ডেটা পুনরুদ্ধার করার জন্য একটি বিকল্প উপস্থাপন করা হয়।

2. এরপরে, ব্যবহারকারী তাদের Google অ্যাকাউন্টে সাইন ইন করে।

3. তারপর, ব্যবহারকারী যখন তাদের ডেটা শেয়ার করার জন্য অনুরোধ করা হয় তখন পরবর্তীতে ক্লিক করে, এবং যখন তারা গোপনীয়তা নীতি গ্রহণ করার জন্য অনুরোধ করা হয় তখন তারা আমি বুঝেছি ক্লিক করে।

4. তারপরে, ব্যবহারকারীকে একটি OAuth সম্মতি স্ক্রীন দেখানো হয় যা অ্যাপ্লিকেশনটিকে তাদের ডেটা অ্যাক্সেস করার অনুমতি দিতে ব্যবহৃত হয়। এখানকার বিকল্পগুলি আপনার কনফিগার করা OAuth স্কোপের সাথে মেলে। ব্যবহারকারী নির্বাচন করে কোন ডেটা ভাগ করতে হবে এবং অ্যাপটি কতক্ষণ সেই ডেটা অ্যাক্সেস করতে পারে (তাদের ডেটাতে এক-বার অ্যাক্সেস বা 30 বা 180 দিনের জন্য সময়-ভিত্তিক অ্যাক্সেস ), তারপরে চালিয়ে যান ক্লিক করুন।

5. অ্যাক্সেসের অনুমতি দেওয়ার পরে, ডেটা আমদানি শুরু হয়। ডেটার আকারের উপর নির্ভর করে, অনুরোধটি সম্পূর্ণ হতে কয়েক মিনিট থেকে কয়েক ঘন্টা সময় নিতে পারে।