REST Resource: advertisers.adGroupAds

সম্পদ: AdGroupAd

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

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

বিজ্ঞাপনের সম্পদের নাম।

advertiser Id

string ( int64 format)

বিজ্ঞাপনটি যে বিজ্ঞাপনদাতার স্বতন্ত্র আইডি।

ad Group Ad Id

string ( int64 format)

বিজ্ঞাপনটির অনন্য আইডি। সিস্টেম দ্বারা বরাদ্দ.

ad Group Id

string ( int64 format)

বিজ্ঞাপনটি যে বিজ্ঞাপন গোষ্ঠীর স্বতন্ত্র আইডি।

display Name

string

বিজ্ঞাপনের প্রদর্শনের নাম।

UTF-8 সর্বোচ্চ 255 বাইটের আকারের সাথে এনকোড করা আবশ্যক।

entity Status

enum ( EntityStatus )

বিজ্ঞাপনের সত্তার অবস্থা।

ad Urls[]

object ( AdUrl )

বিজ্ঞাপন দ্বারা ব্যবহৃত URL এর তালিকা।

ইউনিয়ন ক্ষেত্র ad_details . বিজ্ঞাপনটির বিস্তারিত। ad_details নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
display Video Source Ad

object ( DisplayVideoSourceAd )

একটি Display & Video 360 ক্রিয়েটিভ থেকে প্রাপ্ত একটি বিজ্ঞাপনের বিশদ বিবরণ৷

masthead Ad

object ( MastheadAd )

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

in Stream Ad

object ( InStreamAd )

একটি ইন-স্ট্রীম বিজ্ঞাপনের বিশদ বিবরণ 5 সেকেন্ডের পরে এড়িয়ে যেতে পারে , যা ব্র্যান্ড সচেতনতা বা বিপণনের লক্ষ্যে পৌঁছানোর জন্য ব্যবহৃত হয়।

non Skippable Ad

object ( NonSkippableAd )

6 থেকে 15 সেকেন্ডের মধ্যে একটি অ-ছাড়াযোগ্য ছোট ইন-স্ট্রীম ভিডিও বিজ্ঞাপনের বিশদ বিবরণ, যা বিপণনের লক্ষ্যে পৌঁছানোর জন্য ব্যবহৃত হয়।

bumper Ad

object ( BumperAd )

নাগালের জন্য ব্যবহার করা 6 সেকেন্ডের সমান বা তার কম সময়ের একটি অ-ছাড়াযোগ্য ছোট ভিডিও বিজ্ঞাপনের বিবরণ।

audio Ad

object ( AudioAd )

বিপণনের লক্ষ্যে পৌঁছানোর জন্য ব্যবহৃত একটি অডিও বিজ্ঞাপনের বিবরণ।

video Discover Ad

object ( VideoDiscoveryAd )

একটি ভিডিও প্রচার করে এমন একটি বিজ্ঞাপনের বিশদ বিবরণ যা আবিষ্কারের জায়গায় দেখানো হয়।

video Performance Ad

object ( VideoPerformanceAd )

ব্যবসা, পরিষেবা বা পণ্যে অ্যাকশন চালানোর জন্য ভিডিও অ্যাকশন ক্যাম্পেইনে ব্যবহৃত বিজ্ঞাপনের বিবরণ।

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

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

JSON প্রতিনিধিত্ব 
{
  "creativeId": string
}
ক্ষেত্র
creative Id

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

বিজ্ঞাপনের বর্ণনা।

video Aspect Ratio

enum ( VideoAspectRatio )

মাস্টহেডে স্বয়ংক্রিয়ভাবে চলা YouTube ভিডিওর আকৃতির অনুপাত।

autoplay Video Start Millisecond

string ( int64 format)

মিলিসেকেন্ডে যে সময়ের পরে ভিডিওটি চলতে শুরু করবে।

autoplay Video Duration

string ( Duration format)

ভিডিওটি অটোপ্লে হওয়ার সময়কাল।

নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s ' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s" ।

call To Action Button Label

string

কল-টু-অ্যাকশন বোতামে পাঠ্য।

call To Action Final Url

string

কল-টু-অ্যাকশন বোতামের জন্য গন্তব্য URL।

call To Action Tracking Url

string

কল-টু-অ্যাকশন বোতামের জন্য ট্র্যাকিং URL।

show Channel Art

boolean

একটি YouTube পৃষ্ঠার শীর্ষে প্রদর্শিত একটি ব্যাকগ্রাউন্ড বা ব্যানার দেখাবেন কিনা৷

companion Youtube Videos[]

object ( YoutubeVideoDetails )

ডেস্কটপে মাস্টহেড বিজ্ঞাপনের পাশে প্রদর্শিত ভিডিওগুলি৷ দুটির বেশি হতে পারে না।

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

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

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

string

YouTube ভিডিও আইডি যা YouTube ওয়েবপেজে অনুসন্ধান করা যেতে পারে।

unavailable Reason

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,
    ...
  }
}
ক্ষেত্র
common In Stream Attribute

object ( CommonInStreamAttribute )

সাধারণ বিজ্ঞাপন বৈশিষ্ট্য।

custom Parameters

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)
  }
}
ক্ষেত্র
display Url

string

বিজ্ঞাপনের সাথে প্রদর্শিত ওয়েবপেজের ঠিকানা।

final Url

string

বিজ্ঞাপনে ক্লিক করার পর লোকেরা যে ওয়েবপেজের URL ঠিকানায় পৌঁছায়।

tracking Url

string

ট্র্যাকিং উদ্দেশ্যে পটভূমিতে URL ঠিকানা লোড করা হয়েছে৷

action Button Label

string

কল-টু-অ্যাকশন বোতামে পাঠ্য।

action Headline

string

কল-টু-অ্যাকশন ব্যানারের শিরোনাম।

video

object ( YoutubeVideoDetails )

বিজ্ঞাপনটির ইউটিউব ভিডিও।

companion Banner

object ( ImageAsset )

যে ছবিটি ভিডিও বিজ্ঞাপনের পাশে দেখায়।

ইমেজ অ্যাসেট

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

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

string

ছবির সম্পদের MIME প্রকার।

full Size

object ( Dimensions )

এই ছবির মেটাডেটা তার আসল আকারে।

file Size

string ( int64 format)

বাইটে চিত্র সম্পদের ফাইলের আকার।

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

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

JSON প্রতিনিধিত্ব 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
ক্ষেত্র
common In Stream Attribute

object ( CommonInStreamAttribute )

সাধারণ বিজ্ঞাপন বৈশিষ্ট্য।

custom Parameters

map (key: string, value: string)

ট্র্যাকিং URL টেমপ্লেটে কাস্টম মান পাস করার জন্য কাস্টম প্যারামিটার।

"key": value জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }

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

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

JSON প্রতিনিধিত্ব 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
ক্ষেত্র
common In Stream Attribute

object ( CommonInStreamAttribute )

সাধারণ বিজ্ঞাপন বৈশিষ্ট্য।

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

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

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

string

বিজ্ঞাপনের সাথে প্রদর্শিত ওয়েবপেজের ঠিকানা।

final Url

string

বিজ্ঞাপনে ক্লিক করার পর লোকেরা যে ওয়েবপেজের URL ঠিকানায় পৌঁছায়।

tracking Url

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)
    }
  ]
}
ক্ষেত্র
final Url

string

বিজ্ঞাপনে ক্লিক করার পর লোকেরা যে ওয়েবপেজের URL ঠিকানায় পৌঁছায়।

tracking Url

string

ট্র্যাকিং উদ্দেশ্যে পটভূমিতে URL ঠিকানা লোড করা হয়েছে৷

action Button Labels[]

string

কল-টু-অ্যাকশন বোতামে দেখানো টেক্সট সম্পদের তালিকা।

headlines[]

string

কল-টু-অ্যাকশন ব্যানারে দেখানো শিরোনামের তালিকা।

long Headlines[]

string

কল-টু-অ্যাকশন ব্যানারে দেখানো একমাত্র শিরোনামের তালিকা।

descriptions[]

string

কল-টু-অ্যাকশন ব্যানারে দেখানো বর্ণনার তালিকা।

display Url Breadcrumb1

string

ডিসপ্লে ইউআরএলে ডোমেনের পরে প্রথম অংশ।

display Url Breadcrumb2

string

ডিসপ্লে ইউআরএলে ডোমেনের পরে দ্বিতীয় অংশ।

domain

string

প্রদর্শন URL এর ডোমেন।

videos[]

object ( YoutubeVideoDetails )

এই বিজ্ঞাপন দ্বারা ব্যবহৃত YouTube ভিডিও সম্পদের তালিকা।

custom Parameters

map (key: string, value: string)

ট্র্যাকিং URL টেমপ্লেটে কাস্টম মান পাস করার জন্য কাস্টম প্যারামিটার।

"key": value জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }

companion Banners[]

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

 একটি বিজ্ঞাপন গ্রুপ বিজ্ঞাপন পায়.

list

 বিজ্ঞাপন গ্রুপ বিজ্ঞাপন তালিকা.