REST Resource: advertisers.youtubeAdGroupAds

Display & Video 360 API v2 বাতিল করা হয়েছে এবং 3 সেপ্টেম্বর, 2024- এ সূর্যাস্ত হবে। v3 এ মাইগ্রেশন করতে আপনাকে সাহায্য করতে, মাইগ্রেশন গাইড দেখুন।

• সম্পদ: YoutubeAdGroupAd
  • JSON প্রতিনিধিত্ব
• ডিসপ্লে ভিডিও সোর্স অ্যাড
  • JSON প্রতিনিধিত্ব
• মাস্টহেড অ্যাড
  • JSON প্রতিনিধিত্ব
• ইউটিউব ভিডিও বিবরণ
  • JSON প্রতিনিধিত্ব
• ভিডিও অনুপলব্ধ কারণ
• ভিডিওঅ্যাস্পেক্ট রেশিও
• InStreamAd
  • JSON প্রতিনিধিত্ব
• CommonInStreamAttribute
  • JSON প্রতিনিধিত্ব
• ইমেজ অ্যাসেট
  • JSON প্রতিনিধিত্ব
• নন-স্কিপযোগ্য বিজ্ঞাপন
  • JSON প্রতিনিধিত্ব
• বাম্পার অ্যাড
  • JSON প্রতিনিধিত্ব
• অডিও বিজ্ঞাপন
  • JSON প্রতিনিধিত্ব
• ভিডিও আবিষ্কার বিজ্ঞাপন
  • JSON প্রতিনিধিত্ব
• থাম্বনেইল
• ভিডিও পারফরম্যান্স বিজ্ঞাপন
  • JSON প্রতিনিধিত্ব
• AdUrl
  • JSON প্রতিনিধিত্ব
• AdUrlType
• পদ্ধতি

সম্পদ: YoutubeAdGroupAd

একটি YouTube বিজ্ঞাপন গোষ্ঠীর সাথে যুক্ত একটি একক বিজ্ঞাপন৷

JSON প্রতিনিধিত্ব

{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "entityStatus": enum (EntityStatus), "adUrls": [ { object (AdUrl) } ], // Union field ad_details can be only one of the following: "displayVideoSourceAd": { object (DisplayVideoSourceAd) }, "mastheadAd": { object (MastheadAd) }, "inStreamAd": { object (InStreamAd) }, "nonSkippableAd": { object (NonSkippableAd) }, "bumperAd": { object (BumperAd) }, "audioAd": { object (AudioAd) }, "videoDiscoverAd": { object (VideoDiscoveryAd) }, "videoPerformanceAd": { object (VideoPerformanceAd) } // End of list of possible types for union field ad_details. }

ক্ষেত্র
name	string বিজ্ঞাপনের সম্পদের নাম।
advertiserId	string ( int64 format) বিজ্ঞাপনটি যে বিজ্ঞাপনদাতার স্বতন্ত্র আইডি।
adGroupAdId	string ( int64 format) বিজ্ঞাপনটির অনন্য আইডি। সিস্টেম দ্বারা বরাদ্দ.
adGroupId	string ( int64 format) বিজ্ঞাপনটি যে বিজ্ঞাপন গোষ্ঠীর স্বতন্ত্র আইডি।
displayName	string বিজ্ঞাপনের প্রদর্শনের নাম। UTF-8 সর্বোচ্চ 255 বাইটের আকারের সাথে এনকোড করা আবশ্যক।
entityStatus	enum ( EntityStatus ) বিজ্ঞাপনের সত্তার অবস্থা।
adUrls[]	object ( AdUrl ) বিজ্ঞাপন দ্বারা ব্যবহৃত URL এর তালিকা।
ইউনিয়ন ক্ষেত্র ad_details . বিজ্ঞাপনটির বিস্তারিত। ad_details নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
displayVideoSourceAd	object ( DisplayVideoSourceAd ) একটি Display & Video 360 ক্রিয়েটিভ থেকে প্রাপ্ত একটি বিজ্ঞাপনের বিশদ বিবরণ৷
mastheadAd	object ( MastheadAd ) YouTube হোম ফিডে পরিবেশিত একটি বিজ্ঞাপনের বিশদ বিবরণ।
inStreamAd	object ( InStreamAd ) একটি ইন-স্ট্রীম বিজ্ঞাপনের বিশদ বিবরণ 5 সেকেন্ড পরে এড়িয়ে যেতে পারে , যা ব্র্যান্ড সচেতনতা বা বিপণনের লক্ষ্যে পৌঁছানোর জন্য ব্যবহৃত হয়।
nonSkippableAd	object ( NonSkippableAd ) 6 থেকে 15 সেকেন্ডের মধ্যে একটি অ-ছাড়াযোগ্য ছোট ইন-স্ট্রীম ভিডিও বিজ্ঞাপনের বিশদ বিবরণ, যা বিপণনের লক্ষ্যে পৌঁছানোর জন্য ব্যবহৃত হয়।
bumperAd	object ( BumperAd ) নাগালের জন্য ব্যবহার করা 6 সেকেন্ডের সমান বা তার কম সময়ের একটি অ-ছাড়াযোগ্য ছোট ভিডিও বিজ্ঞাপনের বিবরণ।
audioAd	object ( AudioAd ) বিপণনের লক্ষ্যে পৌঁছানোর জন্য ব্যবহৃত একটি অডিও বিজ্ঞাপনের বিবরণ।
videoDiscoverAd	object ( VideoDiscoveryAd ) একটি ভিডিও প্রচার করে এমন একটি বিজ্ঞাপনের বিশদ বিবরণ যা আবিষ্কারের জায়গায় দেখানো হয়।
videoPerformanceAd	object ( VideoPerformanceAd ) ব্যবসা, পরিষেবা বা পণ্যে অ্যাকশন চালানোর জন্য ভিডিও অ্যাকশন ক্যাম্পেইনে ব্যবহৃত বিজ্ঞাপনের বিবরণ।

ডিসপ্লে ভিডিও সোর্স অ্যাড

বিজ্ঞাপনটি একটি DV360 ক্রিয়েটিভ থেকে নেওয়া হয়েছে।

JSON প্রতিনিধিত্ব
{ "creativeId": string }

ক্ষেত্র
creativeId	string ( int64 format) উৎস সৃজনশীল আইডি.

মাস্টহেড অ্যাড

একটি মাস্টহেড বিজ্ঞাপনের বিশদ বিবরণ।

JSON প্রতিনিধিত্ব

{ "video": { object (YoutubeVideoDetails) }, "headline": string, "description": string, "videoAspectRatio": enum (VideoAspectRatio), "autoplayVideoStartMillisecond": string, "autoplayVideoDuration": string, "callToActionButtonLabel": string, "callToActionFinalUrl": string, "callToActionTrackingUrl": string, "showChannelArt": boolean, "companionYoutubeVideos": [ { object (YoutubeVideoDetails) } ] }

ক্ষেত্র
video	object ( YoutubeVideoDetails ) বিজ্ঞাপনে ইউটিউব ভিডিও ব্যবহার করা হয়েছে।
headline	string বিজ্ঞাপনের শিরোনাম।
description	string বিজ্ঞাপনের বর্ণনা।
videoAspectRatio	enum ( VideoAspectRatio ) মাস্টহেডে স্বয়ংক্রিয়ভাবে চলা YouTube ভিডিওর আকৃতির অনুপাত।
autoplayVideoStartMillisecond	string ( int64 format) মিলিসেকেন্ডে যে সময়ের পরে ভিডিওটি চলতে শুরু করবে।
autoplayVideoDuration	string ( Duration format) ভিডিওটি অটোপ্লে হওয়ার সময়কাল। নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s ' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s" ।
callToActionButtonLabel	string কল-টু-অ্যাকশন বোতামে পাঠ্য।
callToActionFinalUrl	string কল-টু-অ্যাকশন বোতামের জন্য গন্তব্য URL।
callToActionTrackingUrl	string কল-টু-অ্যাকশন বোতামের জন্য ট্র্যাকিং URL।
showChannelArt	boolean একটি YouTube পৃষ্ঠার শীর্ষে প্রদর্শিত একটি ব্যাকগ্রাউন্ড বা ব্যানার দেখাবেন কিনা৷
companionYoutubeVideos[]	object ( YoutubeVideoDetails ) ডেস্কটপে মাস্টহেড বিজ্ঞাপনের পাশে প্রদর্শিত ভিডিওগুলি৷ দুটির বেশি হতে পারে না।

ইউটিউব ভিডিও বিবরণ

একটি YouTube ভিডিওর বিশদ বিবরণ।

JSON প্রতিনিধিত্ব
{ "id": string, "unavailableReason": enum (VideoUnavailableReason) }

ক্ষেত্র
id	string YouTube ভিডিও আইডি যা YouTube ওয়েবপেজে অনুসন্ধান করা যেতে পারে।
unavailableReason	enum ( VideoUnavailableReason ) যে কারণে ভিডিও ডেটা পাওয়া যাচ্ছে না।

ভিডিও অনুপলব্ধ কারণ

সম্ভাব্য কারণগুলি কেন একটি ভিডিও অনুপলব্ধ হতে পারে৷

Enums
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED	অজানা বা অনির্দিষ্ট।
VIDEO_UNAVAILABLE_REASON_PRIVATE	ভিডিওটি ব্যক্তিগত।
VIDEO_UNAVAILABLE_REASON_DELETED	ভিডিওটি মুছে ফেলা হয়েছে।

ভিডিওঅ্যাস্পেক্ট রেশিও

একটি YouTube ভিডিওর জন্য সম্ভাব্য আকৃতির অনুপাত।

Enums
VIDEO_ASPECT_RATIO_UNSPECIFIED	নির্দিষ্ট বা অজানা নয়.
VIDEO_ASPECT_RATIO_WIDESCREEN	ভিডিওটি প্রসারিত করা হয়েছে এবং উপরের এবং নীচে ক্রপ করা হয়েছে।
VIDEO_ASPECT_RATIO_FIXED_16_9	ভিডিওটিতে একটি নির্দিষ্ট 16:9 অনুপাত ব্যবহার করা হয়েছে।

InStreamAd

একটি ইন-স্ট্রীম বিজ্ঞাপনের বিশদ বিবরণ৷

JSON প্রতিনিধিত্ব
{ "commonInStreamAttribute": { object (CommonInStreamAttribute) }, "customParameters": { string: string, ... } }

ক্ষেত্র
commonInStreamAttribute	object ( CommonInStreamAttribute ) সাধারণ বিজ্ঞাপন বৈশিষ্ট্য।
customParameters	map (key: string, value: string) ট্র্যাকিং URL টেমপ্লেটে কাস্টম মান পাস করার জন্য কাস্টম প্যারামিটার। "key": value জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }

CommonInStreamAttribute

ইন-স্ট্রীম, এড়িয়ে যাওয়া যায় না এবং বাম্পার বিজ্ঞাপনের জন্য সাধারণ বৈশিষ্ট্য।

JSON প্রতিনিধিত্ব
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object (YoutubeVideoDetails) }, "companionBanner": { object (ImageAsset) } }

ক্ষেত্র
displayUrl	string বিজ্ঞাপনের সাথে প্রদর্শিত ওয়েবপেজের ঠিকানা।
finalUrl	string বিজ্ঞাপনে ক্লিক করার পর লোকেরা যে ওয়েবপেজের URL ঠিকানায় পৌঁছায়।
trackingUrl	string ট্র্যাকিং উদ্দেশ্যে পটভূমিতে URL ঠিকানা লোড করা হয়েছে৷
actionButtonLabel	string কল-টু-অ্যাকশন বোতামে পাঠ্য।
actionHeadline	string কল-টু-অ্যাকশন ব্যানারের শিরোনাম।
video	object ( YoutubeVideoDetails ) বিজ্ঞাপনটির ইউটিউব ভিডিও।
companionBanner	object ( ImageAsset ) যে ছবিটি ভিডিও বিজ্ঞাপনের পাশে দেখায়।

ইমেজ অ্যাসেট

একটি চিত্র সম্পদের মেটা ডেটা।

JSON প্রতিনিধিত্ব
{ "mimeType": string, "fullSize": { object (Dimensions) }, "fileSize": string }

ক্ষেত্র
mimeType	string ছবির সম্পদের MIME প্রকার।
fullSize	object ( Dimensions ) এই ছবির মেটাডেটা তার আসল আকারে।
fileSize	string ( int64 format) বাইটে চিত্র সম্পদের ফাইলের আকার।

নন-স্কিপযোগ্য বিজ্ঞাপন

এড়িয়ে যাওয়া যায় না এমন বিজ্ঞাপনের বিবরণ।

JSON প্রতিনিধিত্ব
{ "commonInStreamAttribute": { object (CommonInStreamAttribute) }, "customParameters": { string: string, ... } }

ক্ষেত্র
commonInStreamAttribute	object ( CommonInStreamAttribute ) সাধারণ বিজ্ঞাপন বৈশিষ্ট্য।
customParameters	map (key: string, value: string) ট্র্যাকিং URL টেমপ্লেটে কাস্টম মান পাস করার জন্য কাস্টম প্যারামিটার। "key": value জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }

বাম্পার অ্যাড

একটি বাম্পার বিজ্ঞাপনের বিশদ বিবরণ।

JSON প্রতিনিধিত্ব
{ "commonInStreamAttribute": { object (CommonInStreamAttribute) } }

ক্ষেত্র
commonInStreamAttribute	object ( CommonInStreamAttribute ) সাধারণ বিজ্ঞাপন বৈশিষ্ট্য।

অডিও বিজ্ঞাপন

একটি অডিও বিজ্ঞাপনের বিশদ বিবরণ।

JSON প্রতিনিধিত্ব
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "video": { object (YoutubeVideoDetails) } }

ক্ষেত্র
displayUrl	string বিজ্ঞাপনের সাথে প্রদর্শিত ওয়েবপেজের ঠিকানা।
finalUrl	string বিজ্ঞাপনে ক্লিক করার পর লোকেরা যে ওয়েবপেজের URL ঠিকানায় পৌঁছায়।
trackingUrl	string ট্র্যাকিং উদ্দেশ্যে পটভূমিতে URL ঠিকানা লোড করা হয়েছে৷
video	object ( YoutubeVideoDetails ) বিজ্ঞাপনটির ইউটিউব ভিডিও।

ভিডিও আবিষ্কার বিজ্ঞাপন

একটি ভিডিও আবিষ্কার বিজ্ঞাপনের বিশদ বিবরণ৷

JSON প্রতিনিধিত্ব
{ "headline": string, "description1": string, "description2": string, "video": { object (YoutubeVideoDetails) }, "thumbnail": enum (Thumbnail) }

ক্ষেত্র
headline	string বিজ্ঞাপনের শিরোনাম।
description1	string বিজ্ঞাপনের জন্য প্রথম পাঠ্য লাইন।
description2	string বিজ্ঞাপনের জন্য দ্বিতীয় পাঠ্য লাইন।
video	object ( YoutubeVideoDetails ) ইউটিউব ভিডিও বিজ্ঞাপনটি প্রচার করে।
thumbnail	enum ( Thumbnail ) বিজ্ঞাপনে ব্যবহৃত থাম্বনেইল ছবি।

থাম্বনেইল

ভিডিও ডিসকভারি বিজ্ঞাপনে সম্ভাব্য থাম্বনেইল বিকল্প।

Enums
THUMBNAIL_UNSPECIFIED	অজানা বা অনির্দিষ্ট।
THUMBNAIL_DEFAULT	ডিফল্ট থাম্বনেইল, স্বয়ংক্রিয়ভাবে তৈরি বা ব্যবহারকারী-আপলোড হতে পারে।
THUMBNAIL_1	থাম্বনেল 1, ভিডিও থেকে তৈরি করা হয়েছে।
THUMBNAIL_2	থাম্বনেল 2, ভিডিও থেকে তৈরি।
THUMBNAIL_3	থাম্বনেল 3, ভিডিও থেকে তৈরি করা হয়েছে।

ভিডিও পারফরম্যান্স বিজ্ঞাপন

একটি ভিডিও পারফরম্যান্স বিজ্ঞাপনের বিশদ বিবরণ।

JSON প্রতিনিধিত্ব
{ "finalUrl": string, "trackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object (YoutubeVideoDetails) } ], "customParameters": { string: string, ... }, "companionBanners": [ { object (ImageAsset) } ] }

ক্ষেত্র
finalUrl	string বিজ্ঞাপনে ক্লিক করার পর লোকেরা যে ওয়েবপেজের URL ঠিকানায় পৌঁছায়।
trackingUrl	string ট্র্যাকিং উদ্দেশ্যে পটভূমিতে URL ঠিকানা লোড করা হয়েছে৷
actionButtonLabels[]	string কল-টু-অ্যাকশন বোতামে দেখানো টেক্সট সম্পদের তালিকা।
headlines[]	string কল-টু-অ্যাকশন ব্যানারে দেখানো শিরোনামের তালিকা।
longHeadlines[]	string কল-টু-অ্যাকশন ব্যানারে দেখানো একমাত্র শিরোনামের তালিকা।
descriptions[]	string কল-টু-অ্যাকশন ব্যানারে দেখানো বর্ণনার তালিকা।
displayUrlBreadcrumb1	string ডিসপ্লে URL-এ ডোমেনের পরে প্রথম অংশ।
displayUrlBreadcrumb2	string ডিসপ্লে ইউআরএলে ডোমেনের পরে দ্বিতীয় অংশ।
domain	string প্রদর্শন URL এর ডোমেন।
videos[]	object ( YoutubeVideoDetails ) এই বিজ্ঞাপন দ্বারা ব্যবহৃত YouTube ভিডিও সম্পদের তালিকা।
customParameters	map (key: string, value: string) ট্র্যাকিং URL টেমপ্লেটে কাস্টম মান পাস করার জন্য কাস্টম প্যারামিটার। "key": value জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }
companionBanners[]	object ( ImageAsset ) এই বিজ্ঞাপন দ্বারা ব্যবহৃত সহচর ব্যানারগুলির তালিকা৷

AdUrl

বীকন সহ বিজ্ঞাপন সম্পর্কিত অতিরিক্ত URL।

JSON প্রতিনিধিত্ব
{ "type": enum (AdUrlType), "url": string }

ক্ষেত্র
type	enum ( AdUrlType ) বিজ্ঞাপন URL এর ধরন.
url	string URL স্ট্রিং মান।

AdUrlType

সম্ভাব্য বিজ্ঞাপন URL প্রকার।

Enums
AD_URL_TYPE_UNSPECIFIED	অজানা বা অনির্দিষ্ট।
AD_URL_TYPE_BEACON_IMPRESSION	একটি 1x1 ট্র্যাকিং পিক্সেল থেকে পিং করা হয় যখন একটি সৃজনশীলের ছাপ দেওয়া হয়।
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION	প্রসারণযোগ্য DCM ইম্প্রেশন বীকন। পরিবেশন করার সময়, এটি বেশ কয়েকটি বীকনে প্রসারিত হয়।
AD_URL_TYPE_BEACON_CLICK	যখন ক্লিক ইভেন্ট ট্রিগার হয় তখন পিং করার জন্য URL ট্র্যাক করা।
AD_URL_TYPE_BEACON_SKIP	যখন স্কিপ ইভেন্টটি ট্রিগার হয় তখন পিং করার জন্য URL ট্র্যাক করা।

পদ্ধতি
get	একটি YouTube বিজ্ঞাপন গ্রুপ বিজ্ঞাপন পায়.
list	YouTube বিজ্ঞাপন গোষ্ঠীর বিজ্ঞাপনগুলি তালিকাভুক্ত করে৷