REST Resource: advertisers.youtubeAdGroupAds

সম্পদ: 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 বিজ্ঞাপন গোষ্ঠীর বিজ্ঞাপনগুলি তালিকাভুক্ত করে৷