বই_পথ: /distribute/other-docs/_book.yaml প্রকল্প_পথ: /distribute/other-docs/_project.yaml
Engage SDK একটি REST API অফার করে যা iOS এবং Roku TV এর মতো নন-অ্যান্ড্রয়েড প্ল্যাটফর্মগুলিতে ধারাবাহিকভাবে দেখার অভিজ্ঞতা প্রদান করে। API ডেভেলপারদের নন-অ্যান্ড্রয়েড প্ল্যাটফর্ম থেকে নির্বাচিত ব্যবহারকারীদের জন্য "কন্টিনিউ-ওয়াচিং" স্ট্যাটাস আপডেট করার অনুমতি দেয়।
পূর্বশর্ত
- আপনাকে প্রথমে ডিভাইসে Engage SDK-ভিত্তিক ইন্টিগ্রেশন সম্পন্ন করতে হবে। এই গুরুত্বপূর্ণ ধাপটি Google এর ব্যবহারকারী আইডি এবং আপনার অ্যাপের
AccountProfileএর মধ্যে প্রয়োজনীয় সংযোগ স্থাপন করে। - API অ্যাক্সেস এবং প্রমাণীকরণ: আপনার Google Cloud Project-এ API দেখতে এবং সক্ষম করতে, আপনাকে একটি অ্যালোলিস্ট প্রক্রিয়ার মধ্য দিয়ে যেতে হবে। সমস্ত API অনুরোধের জন্য প্রমাণীকরণ প্রয়োজন।
অ্যাক্সেস লাভ করুন
আপনার গুগল ক্লাউড কনসোলে API দেখার এবং সক্ষম করার অ্যাক্সেস পেতে, আপনার অ্যাকাউন্টটি নথিভুক্ত করা প্রয়োজন।
- Google Workspace গ্রাহক আইডি উপলব্ধ থাকা উচিত। যদি উপলব্ধ না হয়, তাহলে আপনাকে একটি Google Workspace সেট আপ করতে হতে পারে, সেইসাথে API কল করার জন্য আপনি যে কোনও Google অ্যাকাউন্ট ব্যবহার করতে চান।
- গুগল ওয়ার্কস্পেসের সাথে সম্পর্কিত একটি ইমেল ব্যবহার করে গুগল ক্লাউড কনসোলে একটি অ্যাকাউন্ট সেট আপ করুন।
- একটি নতুন প্রকল্প তৈরি করুন ।
- API প্রমাণীকরণের জন্য একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন। একবার আপনি পরিষেবা অ্যাকাউন্ট তৈরি করলে, আপনার কাছে দুটি আইটেম থাকবে:
- একটি পরিষেবা অ্যাকাউন্ট আইডি।
- আপনার পরিষেবা অ্যাকাউন্ট কী সহ একটি JSON ফাইল। এই ফাইলটি সুরক্ষিত রাখুন। পরে আপনার ক্লায়েন্টকে API-তে প্রমাণীকরণ করার জন্য এটির প্রয়োজন হবে।
- ওয়ার্কস্পেস এবং সংশ্লিষ্ট Google অ্যাকাউন্টগুলি এখন REST API ব্যবহার করতে পারবে। পরিবর্তনটি কার্যকর হয়ে গেলে আপনাকে জানানো হবে যে APIটি আপনার পরিষেবা অ্যাকাউন্টগুলির দ্বারা কল করার জন্য প্রস্তুত কিনা।
- একটি ডেলিগেটেড API কল করার জন্য প্রস্তুত হতে এই ধাপগুলি অনুসরণ করুন।
প্রকাশনা ধারাবাহিকতা ক্লাস্টার
ভিডিও আবিষ্কারের ডেটা প্রকাশ করতে, নিম্নলিখিত সিনট্যাক্স ব্যবহার করে publishContinuationCluster API-তে একটি POST অনুরোধ সম্পাদন করুন।
https://tvvideodiscovery.googleapis.com/v1/packages/{package_name}/accounts/{account_id}/profiles/{profile_id}/publishContinuationCluster
কোথায়:
-
package_name: মিডিয়া প্রোভাইডার প্যাকেজের নাম -
accountId: আপনার সিস্টেমে ব্যবহারকারীর অ্যাকাউন্টের জন্য একটি অনন্য আইডি। এটি অবশ্যই ডিভাইসের পাথে ব্যবহৃতaccountIdসাথে মিলবে। -
profileId: আপনার সিস্টেমের অ্যাকাউন্টের মধ্যে ব্যবহারকারীর প্রোফাইলের জন্য একটি অনন্য আইডি। এটি অবশ্যই ডিভাইসের পাথে ব্যবহৃত প্রোফাইল আইডির সাথে মিলবে।
প্রোফাইল ছাড়া অ্যাকাউন্টের URL হল:
https://tvvideodiscovery.googleapis.com/v1/packages/{package_name}/accounts/{account_id}/publishContinuationCluster
অনুরোধের পেলোডটি entities ক্ষেত্রের মধ্যে উপস্থাপন করা হয়েছে। entities কন্টেন্ট সত্তার একটি তালিকা উপস্থাপন করে, যা MovieEntity অথবা TVEpisodeEntity হতে পারে। এটি একটি প্রয়োজনীয় ক্ষেত্র।
অনুরোধের মূল অংশ
মাঠ | আদর্শ | প্রয়োজনীয় | বিবরণ |
সত্তা | মিডিয়াএন্টিটি অবজেক্টের তালিকা | হাঁ | সর্বাধিক ৫টি সত্তা সহ কন্টেন্ট সত্তার তালিকা। শুধুমাত্র শীর্ষ পাঁচটি ধরে রাখা হবে এবং বাকিগুলি বাদ দেওয়া হবে। একটি খালি তালিকা অনুমোদিত হলে বোঝা যাবে যে ব্যবহারকারী সমস্ত সত্তা দেখা শেষ করেছেন। |
ফিল্ড entities পৃথক movieEntity এবং tvEpisodeEntity থাকে।
মাঠ | আদর্শ | প্রয়োজনীয় | বিবরণ |
মুভিএন্টিটি | মুভিএন্টিটি | হাঁ | কন্টিনিউয়েশনক্লাস্টারের মধ্যে একটি চলচ্চিত্রের প্রতিনিধিত্বকারী একটি বস্তু। |
tvEpisodeEntity সম্পর্কে | টিভিএপিসোডএন্টিটি | হাঁ | কন্টিনিউয়েশনক্লাস্টারের মধ্যে একটি টিভি পর্বের প্রতিনিধিত্বকারী একটি বস্তু। |
সত্তা অ্যারের প্রতিটি বস্তু অবশ্যই উপলব্ধ MediaEntity ধরণের হতে হবে যেমন MovieEntity এবং TvEpisodeEntity , সাধারণ এবং টাইপ-নির্দিষ্ট ক্ষেত্রগুলির সাথে।
নিম্নলিখিত কোড স্নিপেটটি publishContinuationCluster API-এর জন্য অনুরোধের বডি পেলোড প্রদর্শন করে।
{
"entities": [
{
"movieEntity": {
"watch_next_type": "WATCH_NEXT_TYPE_CONTINUE",
"name": "Movie1",
"platform_specific_playback_uris": [
"https://www.example.com/entity_uri_for_android",
"https://www.example.com/entity_uri_for_iOS"
],
"poster_images": [
"http://www.example.com/movie1_img1.png",
"http://www.example.com/movie1_imag2.png"
],
"last_engagement_time_millis": 864600000,
"duration_millis": 5400000,
"last_play_back_position_time_millis": 3241111
}
},
{
"tvEpisodeEntity": {
"watch_next_type": "WATCH_NEXT_TYPE_CONTINUE",
"name": "TV SERIES EPISODE 1",
"platform_specific_playback_uris": [
"https://www.example.com/entity_uri_for_android",
"https://www.example.com/entity_uri_for_iOS"
],
"poster_images": [
"http://www.example.com/episode1_img1.png",
"http://www.example.com/episode1_imag2.png"
],
"last_engagement_time_millis": 864600000,
"duration_millis": 1800000,
"last_play_back_position_time_millis": 2141231,
"episode_display_number": "1",
"season_number": "1",
"show_title": "title"
}
}
]
}
ভিডিও আবিষ্কারের ডেটা মুছুন
ভিডিও আবিষ্কারের ডেটা সরাতে clearClusters API ব্যবহার করুন।
কন্টিনিউয়েন্স ক্লাস্টার ডেটা মুছে ফেলার জন্য, নিম্নলিখিত সিনট্যাক্স ব্যবহার করে clearClusters API-তে একটি POST অনুরোধ সম্পাদন করুন।
https://tvvideodiscovery.googleapis.com/v1/packages/{package_name}/accounts/{account_id}/profiles/{profile_id}/clearClusters
কোথায়:
-
package_name: মিডিয়া প্রদানকারী প্যাকেজের নাম। -
accountId: আপনার সিস্টেমে ব্যবহারকারীর অ্যাকাউন্টের জন্য একটি অনন্য আইডি। এটি অবশ্যই ডিভাইসের পাথে ব্যবহৃতaccountIdসাথে মিলবে। -
profileId: আপনার সিস্টেমের অ্যাকাউন্টের মধ্যে ব্যবহারকারীর প্রোফাইলের জন্য একটি অনন্য আইডি। এটি অবশ্যই ডিভাইসের পাথে ব্যবহৃত প্রোফাইল আইডির সাথে মিলবে।
clearClusters API-এর পেলোডে শুধুমাত্র একটি ক্ষেত্র থাকে, reason , যার মধ্যে একটি DeleteReason থাকে যা ডেটা অপসারণের কারণ নির্দিষ্ট করে।
{
"reason": "DELETE_REASON_LOSS_OF_CONSENT"
}
পরীক্ষামূলক
সফলভাবে ডেটা পোস্ট করার পরে, Google TV এবং Android এবং iOS Google TV মোবাইল অ্যাপের মতো লক্ষ্য Google পৃষ্ঠগুলিতে "দেখা চালিয়ে যান" সারিতে প্রত্যাশিত সামগ্রী প্রদর্শিত হচ্ছে কিনা তা যাচাই করার জন্য একটি ব্যবহারকারীর পরীক্ষা অ্যাকাউন্ট ব্যবহার করুন।
পরীক্ষা করার সময়, কয়েক মিনিটের যুক্তিসঙ্গত প্রচার বিলম্বের অনুমতি দিন এবং ঘড়ির প্রয়োজনীয়তাগুলি মেনে চলুন, যেমন কোনও সিনেমার অংশ দেখা বা কোনও পর্ব শেষ করা। বিস্তারিত জানার জন্য অ্যাপ ডেভেলপারদের জন্য পরবর্তী দেখুন নির্দেশিকা দেখুন।