YouTube নির্মাতার অন্তর্দৃষ্টি

ক্রিয়েটর ইনসাইটস ফিচারের মাধ্যমে ইউটিউব ক্রিয়েটরদের সম্পর্কে তথ্য জানুন ও সংগ্রহ করুন। এটি সেইসব এজেন্সি এবং বিজ্ঞাপনদাতাদের জন্য সহায়ক হতে পারে, যারা তাদের টার্গেট অডিয়েন্সের জন্য প্রাসঙ্গিক ক্রিয়েটরদের খুঁজে পেতে চান।

এপিআই-টির চারটি প্রধান কাজ রয়েছে:

  1. ক্রিয়েটরদের খুঁজে পাওয়ার সুবিধা: নির্দিষ্ট কিছু বিষয়, জনসংখ্যাতাত্ত্বিক বৈশিষ্ট্য, দর্শকগোষ্ঠী বা ক্রিয়েটরের বৈশিষ্ট্য অনুযায়ী প্রাসঙ্গিক ক্রিয়েটরদের খুঁজুন।
  2. ক্রিয়েটর টপিক ইনসাইটস: নির্দিষ্ট বিষয় নিয়ে কন্টেন্ট তৈরি করেন এমন প্রাসঙ্গিক ক্রিয়েটরদের সম্পর্কে তথ্য সংগ্রহ করুন।
  3. ক্রিয়েটর ইনসাইটস: নির্দিষ্ট ইউটিউব চ্যানেল সম্পর্কে তথ্য সংগ্রহ করুন, যেমন তাদের সাবস্ক্রাইবার সংখ্যা, ভিউ সংখ্যা এবং দর্শকের জনসংখ্যাতাত্ত্বিক বৈশিষ্ট্য।
  4. ট্রেন্ডিং ইনসাইটস: নির্দিষ্ট দর্শক বা বিষয়ের উপর ভিত্তি করে বিশেষ ট্রেন্ড সম্পর্কে তথ্য সংগ্রহ করুন।

টপিক-ভিত্তিক ক্রিয়েটর ডিসকভারি বা ট্রেন্ডিং ইনসাইটস ব্যবহার করার সময়, অতিরিক্ত ডেটা অনুরোধ করার মাধ্যমে স্থানীয় ক্রিয়েটর ডিসকভারি (অর্থাৎ, কোনো নির্দিষ্ট দেশে বসবাসকারী বা সেখান থেকে পোস্ট করা এবং সেই দেশেই দেখা হয় এমন ক্রিয়েটরদের খুঁজে বের করা) সমর্থন করা হয়। এছাড়াও, অতিরিক্ত ডেটা অনুরোধ করে আপনি টপিক-ভিত্তিক ট্রেন্ডিং ইনসাইটসের জন্য ব্র্যান্ড সেন্টিমেন্ট ইনসাইটসও চাইতে পারেন।

যোগ্যতার শর্তাবলী

GenerateCreatorInsights হলো Google Ads API-এর একটি প্রাইভেট কম্পোনেন্ট, যা একটি নন-এক্সক্লুসিভ ও রয়্যালটি-মুক্ত ডেটা লাইসেন্সের অধীনে প্রদান করা হয়। চুক্তিবদ্ধ পার্টনাররা YouTube ক্রিয়েটর ও কন্টেন্ট অন্বেষণ করার জন্য স্ট্যান্ডার্ড Google Ads ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে পারেন। যোগ্য হতে হলে, পার্টনারদের অবশ্যই নিম্নলিখিত শর্তগুলো পূরণ করতে হবে:

  • এমন একটি পরিকল্পনা টুল বা ইউজার ইন্টারফেস রাখুন যা গুগল অ্যাডস এপিআই (Google Ads API)-কে ইন্টিগ্রেট করবে।
  • Use the API to explore YouTube content and creators for potential advertising opportunities.
  • যোগ্যতা নিশ্চিত করার জন্য একটি প্রাথমিক বাছাই মূল্যায়ন সম্পন্ন করুন।
  • ডেটা ব্যবহারের নিয়মাবলী অনুসরণ করুন এবং পর্যায়ক্রমিক ডেটা নিরীক্ষার জন্য প্রস্তুত থাকুন।
  • Sign a data-licensing agreement that legally enforces data usage requirements.
  • গুগল অ্যাডস এপিআই- এর পরিষেবার শর্তাবলী গ্রহণ করুন।

আরও তথ্যের জন্য আপনার গুগল প্রতিনিধির সাথে যোগাযোগ করুন।

নির্মাতার অন্তর্দৃষ্টি তৈরি করুন

ক্রিয়েটর ইনসাইটস তৈরি করতে, GenerateCreatorInsights মেথডে একটি অনুরোধ পাঠান। এই মেথডটির প্রতি সেকেন্ডে ৫টি কোয়েরি (QPS) করার সীমা রয়েছে। আপনি ক্রিয়েটরদের খুঁজে বের করার সুবিধা, বিষয় অনুযায়ী প্রাসঙ্গিক ক্রিয়েটরদের অনুসন্ধান, নাকি ক্রিয়েটরদের সম্পর্কে অন্তর্দৃষ্টি পেতে চান, তার উপর নির্ভর করে এটি বিভিন্ন ধরনের ইনপুট গ্রহণ করে। আপনি যে দেশগুলো থেকে ডেটা পেতে চান, সেই দেশগুলোর অবস্থান অবশ্যই জানাতে হবে।

  1. ক্রিয়েটরদের সহজে খুঁজে পাওয়ার সুবিধা: আপনি অডিয়েন্সের বিভিন্ন অ্যাট্রিবিউটের একটি তালিকা দিতে পারেন, যেমন বয়স, লিঙ্গ এবং ব্যবহারকারীর আগ্রহ (যার মধ্যে অ্যাফিনিটি, ইন-মার্কেট এবং লাইফ ইভেন্ট অডিয়েন্স অন্তর্ভুক্ত)। এপিআইটি সেইসব ক্রিয়েটরদের একটি তালিকা ফেরত দেয়, যাদের অডিয়েন্স ঐ অ্যাট্রিবিউটগুলোর সাথে মিলে যায়। এছাড়াও, আপনি ক্রিয়েটরের অ্যাট্রিবিউটগুলো প্রদান করে সেইসব ক্রিয়েটরদের ফিল্টার করতে পারেন, যাদের কন্টেন্ট বিশেষভাবে আপনার দেওয়া অ্যাট্রিবিউটগুলোর সাথে মিলে যায়।

    আপনি ListAudienceInsightsAttributes ব্যবহার করে উপলব্ধ অডিয়েন্স অ্যাট্রিবিউটগুলো পুনরুদ্ধার করতে পারেন। এর জন্য আপনাকে সেই ডাইমেনশনগুলো প্রদান করতে হবে যেগুলোর জন্য আপনি অ্যাট্রিবিউট চান, যেমন আগ্রহের বিষয়গুলোর জন্য KNOWLEDGE_GRAPH ।

    Google Ads API v23 থেকে, আপনি audience_combinations ব্যবহার করে অডিয়েন্স অ্যাট্রিবিউটের মধ্যে জটিল সম্পর্ক নির্দিষ্ট করতে পারেন। এই ফিল্ডটি আপনাকে বুলিয়ান লজিক (AND/OR) ব্যবহার করে অডিয়েন্স নির্ধারণ করতে দেয়, যা audience_attributes দিয়ে সম্ভব নয়।

    যদিও audience_attributes একাধিক সংযুক্ত (OR দ্বারা যুক্ত) অ্যাট্রিবিউটের তালিকার উপর ভিত্তি করে টার্গেট করার জন্য উপযুক্ত (যেমন, "খেলাধুলা" অথবা "ভ্রমণ" অথবা ...-এ আগ্রহী ব্যবহারকারী), audience_combinations আরও সূক্ষ্ম নিয়ন্ত্রণ প্রদান করে। audience_combinations এর অন্তর্ভুক্ত প্রতিটি InsightsAudienceAttributeGroup একটি লজিক্যাল OR দ্বারা অ্যাট্রিবিউটগুলোকে সংযুক্ত করে। এরপর এই গ্রুপগুলোকে একটি লজিক্যাল AND দ্বারা সংযুক্ত করা হয়।

    উদাহরণস্বরূপ, "ত্বকের যত্ন" অথবা "চুলের যত্ন" এবং সেইসাথে "প্রসাধনী"-তে আগ্রহী এমন একটি দর্শকগোষ্ঠীকে লক্ষ্য করতে, আপনি audience_combinations এ দুটি InsightsAudienceAttributeGroup আইটেম ব্যবহার করবেন। "ত্বকের যত্ন", "চুলের যত্ন" এবং "প্রসাধনী" হলো আগ্রহের বিষয়, যা নলেজ গ্রাফ এনটিটি দ্বারা উপস্থাপিত হয় (উদাহরণস্বরূপ, প্রসাধনীর জন্য /m/014trl )। প্রথম গ্রুপটিতে "ত্বকের যত্ন" এবং "চুলের যত্ন"-এর জন্য নলেজ গ্রাফ এনটিটি অ্যাট্রিবিউট থাকবে, এবং দ্বিতীয় গ্রুপটিতে "প্রসাধনী"-এর জন্য নলেজ গ্রাফ এনটিটি অ্যাট্রিবিউট থাকবে।

    মনে রাখবেন যে, যদি আপনি audience_attributes এ নলেজ গ্রাফ এনটিটি, প্রোডাক্ট ও সার্ভিস ক্যাটাগরি, অথবা ব্যবহারকারীর আগ্রহ উল্লেখ করেন, তাহলে আপনি audience_combinations ব্যবহার করতে পারবেন না। যদি আপনি audience_combinations ব্যবহার করেন, তবে আপনাকে অবশ্যই এই অ্যাট্রিবিউটগুলো audience_combinations পরিবর্তে audience_attributes মধ্যেই উল্লেখ করতে হবে; তবে, আপনি audience_combinations সাথে একত্রে ডেমোগ্রাফিক্সের মতো অন্যান্য অ্যাট্রিবিউট টাইপের জন্য audience_attributes ব্যবহার করতে পারবেন।

  2. ক্রিয়েটর টপিক ইনসাইটস: ` search_topics ফিল্ড ব্যবহার করে কন্টেন্টের টপিকগুলোর একটি তালিকা দিন। এপিআই সেইসব প্রাসঙ্গিক ক্রিয়েটরদের তালিকা ফেরত দেয়, যারা নির্দিষ্ট টপিকগুলো নিয়ে কন্টেন্ট তৈরি করেন। country_locations এ উল্লেখিত দেশের উপর ভিত্তি করে ডেটা সংগ্রহ করা হয়। উল্লেখ্য যে, এই অপশনটি দিয়ে শুধুমাত্র একটি দেশের জন্য সার্চ করা যাবে।

    SearchTopics ফিল্ডের সমর্থিত এনটিটিগুলোকে অবশ্যই CONTENT_TRENDING_INSIGHTS অথবা CREATOR_TOPIC_INSIGHTS ক্যাপাবিলিটি দিয়ে ট্যাগ করা থাকতে হবে। সমর্থিত এনটিটি ক্যাপাবিলিটিগুলো পুনরুদ্ধার করতে ListAudienceInsightsAttributes মেথডটি ব্যবহার করুন।

    দ্রষ্টব্য: search_brand অপশনটি `v24.2`-এ বাতিল করা হয়েছে এবং `v25` থেকে সরিয়ে ফেলা হয়েছে। এর পরিবর্তে search_topics ব্যবহার করুন।

  3. ক্রিয়েটর ইনসাইটস: search_channels ফিল্ড ব্যবহার করে ইউটিউব চ্যানেল আইডিগুলোর একটি তালিকা দিন। এপিআইটি সেই নির্দিষ্ট চ্যানেলগুলো সম্পর্কে ইনসাইটস ফেরত দেবে।

সম্পূরক ডেটা এবং স্থানীয় নির্মাতারা

ডিফল্টরূপে, শুধুমাত্র মূল ইনসাইট ডেটা ফেরত দেওয়া হয়। আপনি রিপিটেড ফিল্ড ' supplemental_data সেট করার মাধ্যমে আপনার রেসপন্সে ঐচ্ছিক ফিচার এবং অতিরিক্ত ডেটার জন্য অনুরোধ করতে পারেন।

উদাহরণস্বরূপ, আপনি supplemental_data ফিল্ডে LOCAL_CREATOR_DATA enum ভ্যালুটি যোগ করে স্থানীয় ক্রিয়েটরের ডেটার জন্য অনুরোধ করতে পারেন। আপনি যদি search_topics ব্যবহার করে ক্রিয়েটরদের খোঁজেন (এবং টপিকটি যদি CREATOR_TOPIC_INSIGHTS ক্যাপাবিলিটি দিয়ে ট্যাগ করা একটি নলেজ গ্রাফ এনটিটি হয়), তাহলে API-টি রেসপন্সের local_creator_insights ফিল্ডটি সেইসব স্থানীয় ক্রিয়েটরদের দিয়ে পূরণ করে দেবে, যারা তাদের লোকেশন ডেটা শেয়ার করতে সম্মতি দিয়েছেন।

স্থানীয় নির্মাতা আবিষ্কারের জন্য নিম্নলিখিত নির্দিষ্টকরণগুলি লক্ষ্য করুন:

  • সংজ্ঞা: "স্থানীয় নির্মাতা" হলেন সেইসব নির্মাতা যারা নির্বাচিত দেশে বসবাস করেন বা সেখান থেকে পোস্ট করেন এবং যাদের পোস্ট সেই দেশেই দেখা হয়।
  • Constraint: Local creator discovery is not supported when sub_country_locations is set in the request.
  • সক্ষমতা: আপনি ListAudienceInsightsAttributes ব্যবহার করে সমর্থিত নলেজ গ্রাফ এনটিটি এবং তাদের সক্ষমতার তালিকা পেতে পারেন।

generateCreatorInsights মেথডটি একটি GenerateCreatorInsightsResponse অবজেক্ট রিটার্ন করে। এই অবজেক্টটিতে নিম্নলিখিত ফিল্ডগুলো থাকে:

  • creator_insights : আপনার মূল শর্তের সাথে মেলে এমন YouTubeCreatorInsights অবজেক্টগুলির একটি তালিকা।
  • local_creator_insights : স্থানীয় ক্রিয়েটরদের জন্য YouTubeCreatorInsights অবজেক্টের একটি তালিকা। এটি শুধুমাত্র তখনই পূরণ করা হয় যখন LOCAL_CREATOR_DATA অনুরোধ করা হয় এবং ব্যবহৃত ক্রাইটেরিয়াটি search_topics হয়।

প্রতিটি YouTubeCreatorInsights অবজেক্টে একজন ক্রিয়েটর সম্পর্কে নিম্নলিখিত তথ্য থাকে:

  • Creator name
  • ইউটিউব চ্যানেল
  • মোট নির্মাতা মেট্রিক্স
  • ইউটিউব চ্যানেল ইনসাইটসের তালিকা

YouTubeMetrics অবজেক্টটিতে নিম্নলিখিত মেট্রিকগুলো রয়েছে:

কোনো ক্রিয়েটর মৌলিক ব্র্যান্ডেড কন্টেন্ট পার্টনারশিপের জন্য যোগ্য কিনা তা শনাক্ত করতে, partnership_opportunities দেখুন; তালিকায় CREATOR_PARTNERSHIPS ভ্যালুটি থাকলে একজন ক্রিয়েটর যোগ্য বলে বিবেচিত হবেন।

YouTubeChannelInsights অবজেক্টটিতে একটি ইউটিউব চ্যানেল সম্পর্কে নিম্নলিখিত তথ্য থাকে:

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

ট্রেন্ডিং ইনসাইটস তৈরি করতে, GenerateTrendingInsights মেথডে একটি অনুরোধ পাঠান। এই মেথডটির প্রতি সেকেন্ডে ৫টি কোয়েরি (QPS) করার সীমা রয়েছে। আপনি অডিয়েন্স ট্রেন্ড নাকি টপিক ট্রেন্ড পেতে চান, তার উপর নির্ভর করে এটি দুই ধরনের ইনপুট গ্রহণ করে। আপনি যে নির্দিষ্ট দেশের অবস্থান থেকে ট্রেন্ড পেতে চান, তা আপনাকে অবশ্যই উল্লেখ করতে হবে।

  1. অডিয়েন্স ট্রেন্ড: আপনি অডিয়েন্সের অ্যাট্রিবিউট, যেমন বয়স, লিঙ্গ এবং ব্যবহারকারীর আগ্রহের (অ্যাফিনিটি, ইন-মার্কেট এবং লাইফ ইভেন্ট অডিয়েন্স সহ) একটি তালিকা প্রদান করতে পারেন। এপিআইটি সেই অডিয়েন্সগুলোর জন্য ট্রেন্ডিং ইনসাইটসের একটি তালিকা ফেরত দেয়, যার মধ্যে তুলনামূলক সময়কালে ট্রেন্ডের মানের শতাংশ পরিবর্তনের মতো মেট্রিকও অন্তর্ভুক্ত থাকে।

    আপনি ListAudienceInsightsAttributes ব্যবহার করে উপলব্ধ অডিয়েন্স অ্যাট্রিবিউটগুলো পুনরুদ্ধার করতে পারেন। এর জন্য আপনাকে সেই ডাইমেনশনগুলো প্রদান করতে হবে যেগুলোর জন্য আপনি অ্যাট্রিবিউট চান, যেমন আগ্রহের বিষয়গুলোর জন্য KNOWLEDGE_GRAPH ।

    Google Ads API v23 থেকে, আপনি audience_combinations ব্যবহার করে অডিয়েন্স অ্যাট্রিবিউটের মধ্যে জটিল সম্পর্ক নির্দিষ্ট করতে পারেন। এই ফিল্ডটি আপনাকে বুলিয়ান লজিক (AND/OR) ব্যবহার করে অডিয়েন্স নির্ধারণ করতে দেয়, যা audience_attributes দিয়ে সম্ভব নয়।

    যদিও audience_attributes একাধিক সংযুক্ত (OR দ্বারা যুক্ত) অ্যাট্রিবিউটের তালিকার উপর ভিত্তি করে টার্গেট করার জন্য উপযুক্ত (যেমন, "খেলাধুলা" অথবা "ভ্রমণ" অথবা ...-এ আগ্রহী ব্যবহারকারী), audience_combinations আরও সূক্ষ্ম নিয়ন্ত্রণ প্রদান করে। audience_combinations এর অন্তর্ভুক্ত প্রতিটি InsightsAudienceAttributeGroup একটি লজিক্যাল OR দ্বারা অ্যাট্রিবিউটগুলোকে সংযুক্ত করে। এরপর এই গ্রুপগুলোকে একটি লজিক্যাল AND দ্বারা সংযুক্ত করা হয়।

    উদাহরণস্বরূপ, "ত্বকের যত্ন" অথবা "চুলের যত্ন" এবং সেইসাথে "প্রসাধনী"-তে আগ্রহী এমন একটি দর্শকগোষ্ঠীকে লক্ষ্য করতে, আপনি audience_combinations এ দুটি InsightsAudienceAttributeGroup আইটেম ব্যবহার করবেন। "ত্বকের যত্ন", "চুলের যত্ন" এবং "প্রসাধনী" হলো আগ্রহের বিষয়, যা নলেজ গ্রাফ এনটিটি দ্বারা উপস্থাপিত হয় (উদাহরণস্বরূপ, প্রসাধনীর জন্য /m/014trl )। প্রথম গ্রুপটিতে "ত্বকের যত্ন" এবং "চুলের যত্ন"-এর জন্য নলেজ গ্রাফ এনটিটি অ্যাট্রিবিউট থাকবে, এবং দ্বিতীয় গ্রুপটিতে "প্রসাধনী"-এর জন্য নলেজ গ্রাফ এনটিটি অ্যাট্রিবিউট থাকবে।

    মনে রাখবেন যে, যদি আপনি audience_attributes এ নলেজ গ্রাফ এনটিটি, প্রোডাক্ট ও সার্ভিস ক্যাটাগরি, অথবা ব্যবহারকারীর আগ্রহ উল্লেখ করেন, তাহলে আপনি audience_combinations ব্যবহার করতে পারবেন না। যদি আপনি audience_combinations ব্যবহার করেন, তবে আপনাকে অবশ্যই এই অ্যাট্রিবিউটগুলো audience_combinations পরিবর্তে audience_attributes মধ্যেই উল্লেখ করতে হবে; তবে, আপনি audience_combinations সাথে একত্রে ডেমোগ্রাফিক্সের মতো অন্যান্য অ্যাট্রিবিউট টাইপের জন্য audience_attributes ব্যবহার করতে পারবেন।

    KNOWLEDGE_GRAPH অ্যাট্রিবিউটগুলিতে এক বা একাধিক InsightsKnowledgeGraphEntityCapabilities ট্যাগ থাকবে। Trending Insights-এর জন্য সমর্থিত অ্যাট্রিবিউটগুলির রেসপন্স মেটাডেটাতে প্রাসঙ্গিক ট্যাগ থাকবে।

    উল্লেখ্য যে, ContentCreatorInsightsService এ অ্যাক্সেস থাকা ডেভেলপাররা স্বয়ংক্রিয়ভাবে AudienceInsightsService.ListAudienceInsightsAttributes এও অ্যাক্সেস পাবেন। AudienceInsightsService এর অন্যান্য এন্ডপয়েন্টগুলোর জন্য একটি স্বতন্ত্র allowlist প্রক্রিয়ার প্রয়োজন হয়।

    ListAudienceInsightsAttributes সম্পর্কিত অতিরিক্ত তথ্য Audience Insights গাইড- এ পাওয়া যাবে।

  2. টপিক ট্রেন্ড: কন্টেন্ট টপিকের একটি তালিকা প্রদান করুন। এপিআই সেই টপিকগুলোর জন্য ট্রেন্ডিং ইনসাইটের একটি তালিকা ফেরত দেয়, যার মধ্যে তুলনামূলক সময়কালে ট্রেন্ডের মানের শতাংশ পরিবর্তনের মতো মেট্রিক অন্তর্ভুক্ত থাকে। আপনি সম্পূরক ডেটার অনুরোধ করে ব্র্যান্ড টপিকগুলোর জন্য ব্র্যান্ড সেন্টিমেন্ট ইনসাইটও চাইতে পারেন।

ক্রিয়েটর ইনসাইটস তৈরি করার মতোই, আপনি রিপিটেড ফিল্ড supplemental_data LOCAL_CREATOR_DATA বা BRAND_SENTIMENT_DATA তে সেট করে ট্রেন্ডিং ইনসাইটস-এ ঐচ্ছিক ফিচারের জন্য অনুরোধ করতে পারেন।

আপনার ট্রেন্ডিং অনুরোধে যদি search_topics ব্যবহৃত হয়, তাহলে supplemental_data LOCAL_CREATOR_DATA তে সেট করলে, ফেরত আসা TrendInsight অবজেক্টের ` related_local_creators ফিল্ডটি অনুরোধকৃত টপিকের সেইসব সম্পর্কিত স্থানীয় ক্রিয়েটরদের দিয়ে পূরণ হয়ে যাবে, যারা তাদের অবস্থানের ডেটা শেয়ার করতে সম্মতি দিয়েছেন। স্থানীয় ক্রিয়েটর শনাক্তকরণ একই সংজ্ঞা এবং সীমাবদ্ধতার অধীন (যেমন sub_country_locations সাথে অসামঞ্জস্যপূর্ণ হওয়া)।

আপনার ট্রেন্ডিং অনুরোধে যদি search_topics ব্যবহৃত হয়, তাহলে supplemental_data BRAND_SENTIMENT_DATA তে সেট করলে, অনুরোধকৃত নলেজ গ্রাফ এনটিটি টপিকটির BRAND ক্যাপাবিলিটি থাকলে ফেরত আসা TrendInsight অবজেক্টের brand_sentiment_insights ফিল্ডটি পূরণ হয়ে যাবে। একটি ব্র্যান্ড টপিক হলো BRAND ক্যাপাবিলিটি দ্বারা ট্যাগ করা একটি এনটিটি। আপনি ListAudienceInsightsAttributes মেথডটি ব্যবহার করে সমর্থিত এনটিটি ক্যাপাবিলিটিগুলো পুনরুদ্ধার করতে পারেন।

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

GenerateTrendingInsights মেথডটি TrendInsight অবজেক্টের একটি তালিকা রিটার্ন করে, যার প্রতিটিতে থাকে:

  • trend_attribute : ট্রেন্ডটির জন্য প্রাথমিক AudienceInsightsAttributeMetadata ।
  • trend_metrics : প্রবণতার মেট্রিকসমূহ, যেমন তুলনাকালীন সময়ের শতকরা পরিবর্তন।
  • trend_data_points : Historical data points for the trend. Only populated for trends using search_topics .
  • related_videos : ট্রেন্ডের বিষয়ের সাথে সম্পর্কিত ট্রেন্ডিং ভিডিওগুলির জন্য AudienceInsightsAttributeMetadata অবজেক্টের একটি তালিকা। শুধুমাত্র search_topics ব্যবহার করে এমন ট্রেন্ডগুলির জন্য এটি পূরণ করা হয়। এই অ্যাট্রিবিউটগুলির জন্য, নেস্টেড YouTubeVideoAttributeMetadata পূরণ করা হয়, যাতে ভিডিও-স্তরের মেটাডেটা (যেমন ভিডিও URL, থাম্বনেইল URL, এবং ভিউ বা লাইক সংখ্যা) এবং চ্যানেল-স্তরের মেটাডেটা (যেমন চ্যানেল আইডি, নাম, এবং URL) থাকে।
  • brand_sentiment_insights : ট্রেন্ডটির জন্য BrandSentimentInsight অবজেক্টগুলোর একটি তালিকা। এটি শুধুমাত্র তখনই পূরণ করা হয় যখন ট্রেন্ড অনুরোধে search_topics ব্যবহৃত হয়, নলেজ গ্রাফ এনটিটি টপিকটির BRAND ক্যাপাবিলিটি থাকে, এবং supplemental_data তে BRAND_SENTIMENT_DATA অনুরোধ করা হয়। প্রতিটি BrandSentimentInsight অবজেক্টে থাকে:
    • month : যে মাসটিকে ব্র্যান্ড সেন্টিমেন্টটি YYYY-MM ফরম্যাটে উপস্থাপন করে।
    • has_insufficient_data : ব্র্যান্ড সেন্টিমেন্ট গণনা করার জন্য পর্যাপ্ত ডেটা আছে কিনা।
    • sentiment_distributions : ইতিবাচক, নেতিবাচক এবং নিরপেক্ষ মনোভাবের বন্টন, যা প্রতিটি মনোভাবের সাথে সম্পর্কিত ব্র্যান্ডের ভিডিওগুলির ভিউয়ের অনুপাত হিসাবে গণনা করা হয়।
    • sentiment_summaries : ব্র্যান্ড সম্পর্কিত কন্টেন্টের ইতিবাচক ও নেতিবাচক দিকগুলোর AI-দ্বারা তৈরি সারাংশ, সাথে প্রতিটি সেন্টিমেন্টের জন্য নমুনা ভিডিও। সারাংশ শুধুমাত্র ইতিবাচক এবং নেতিবাচক সেন্টিমেন্টের জন্যই তৈরি করা হয়, নিরপেক্ষ সেন্টিমেন্টের জন্য নয়।
পূর্ববর্তী
শ্রোতা অন্তর্দৃষ্টি