REST Resource: advertisers.youtubeAdGroupAds

संसाधन: YouTubeAdGroupAd

किसी YouTube विज्ञापन ग्रुप से जुड़ा एक विज्ञापन.

जेएसओएन के काेड में दिखाना
{
  "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)

विज्ञापन में इस्तेमाल किए गए यूआरएल की सूची.

यूनियन फ़ील्ड ad_details. विज्ञापन की जानकारी. ad_details इनमें से सिर्फ़ एक हो सकती है:
displayVideoSourceAd

object (DisplayVideoSourceAd)

Display & Video 360 क्रिएटिव से लिए गए विज्ञापन की जानकारी.

mastheadAd

object (MastheadAd)

YouTube के होम फ़ीड पर दिखाए जाने वाले विज्ञापन की जानकारी.

inStreamAd

object (InStreamAd)

पांच सेकंड के बाद स्किप किए जा सकने वाले इन-स्ट्रीम विज्ञापन की जानकारी, जिसका इस्तेमाल ब्रैंड जागरूकता बढ़ाने या मार्केटिंग के लक्ष्यों को हासिल करने के लिए किया जाता है.

nonSkippableAd

object (NonSkippableAd)

पहुंच मार्केटिंग के लक्ष्यों के लिए इस्तेमाल किए जाने वाले, 6 से 15 सेकंड के स्किप न किए जा सकने वाले छोटे इन-स्ट्रीम वीडियो विज्ञापन की जानकारी.

bumperAd

object (BumperAd)

स्किप न किए जा सकने वाले छोटे वीडियो विज्ञापन की जानकारी. यह छह सेकंड या उससे कम अवधि के ऐसे छोटे वीडियो विज्ञापन की जानकारी होती है जिसका इस्तेमाल पहुंच बढ़ाने के लिए किया जाता है.

audioAd

object (AudioAd)

मार्केटिंग के लक्ष्यों को पूरा करने के लिए इस्तेमाल किए जाने वाले ऑडियो विज्ञापन की जानकारी.

videoDiscoverAd

object (VideoDiscoveryAd)

वीडियो का प्रमोशन करने वाले विज्ञापन से जुड़ी जानकारी, जो खोज की जगहों पर दिखती है.

videoPerformanceAd

object (VideoPerformanceAd)

कारोबार, सेवा या प्रॉडक्ट के लिए ऐक्शन बढ़ाने के लिए, वीडियो ऐक्शन कैंपेन में इस्तेमाल किए गए विज्ञापन की जानकारी.

DisplayVideoSourceAd

यह विज्ञापन, DV360 क्रिएटिव से लिया गया है.

जेएसओएन के काेड में दिखाना
{
  "creativeId": string
}
फ़ील्ड
creativeId

string (int64 format)

सोर्स क्रिएटिव का आईडी.

MastheadAd

मास्टहेड विज्ञापन की जानकारी.

जेएसओएन के काेड में दिखाना
{
  "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)

विज्ञापन में इस्तेमाल किया गया YouTube वीडियो.

headline

string

विज्ञापन का शीर्षक.

description

string

विज्ञापन का ब्यौरा.

videoAspectRatio

enum (VideoAspectRatio)

मास्टहेड पर अपने-आप चलने वाले YouTube वीडियो का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात).

autoplayVideoStartMillisecond

string (int64 format)

मिलीसेकंड में वह समय जिसके बाद वीडियो चलना शुरू होगा.

autoplayVideoDuration

string (Duration format)

वीडियो कितनी देर तक अपने-आप चलेगा.

सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह 's' पर खत्म होता है. उदाहरण: "3.5s".

callToActionButtonLabel

string

कॉल-टू-ऐक्शन बटन पर मौजूद टेक्स्ट.

callToActionFinalUrl

string

कॉल-टू-ऐक्शन बटन का डेस्टिनेशन यूआरएल (विज्ञापन के लैंडिंग पेज का यूआरएल).

callToActionTrackingUrl

string

कॉल-टू-ऐक्शन बटन के लिए ट्रैकिंग यूआरएल.

showChannelArt

boolean

YouTube पेज में सबसे ऊपर दिखने वाला बैकग्राउंड या बैनर दिखाना है या नहीं.

companionYoutubeVideos[]

object (YoutubeVideoDetails)

डेस्कटॉप पर मास्टहेड विज्ञापन के बगल में दिखने वाले वीडियो. दो से ज़्यादा नहीं हो सकते.

YoutubeVideoDetails

किसी YouTube वीडियो की जानकारी.

जेएसओएन के काेड में दिखाना
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}
फ़ील्ड
id

string

YouTube वीडियो का आईडी, जिसे YouTube वेबपेज पर खोजा जा सकता है.

unavailableReason

enum (VideoUnavailableReason)

वीडियो का डेटा उपलब्ध न होने की वजह.

VideoUnavailableReason

वीडियो उपलब्ध न होने की ये वजहें हो सकती हैं.

Enums
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED कोई जानकारी नहीं है या तय नहीं किया गया है.
VIDEO_UNAVAILABLE_REASON_PRIVATE वीडियो 'निजी' के तौर पर सेट है.
VIDEO_UNAVAILABLE_REASON_DELETED वीडियो को मिटा दिया गया है.

VideoAspectRatio

किसी YouTube वीडियो के लिए संभावित आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात).

Enums
VIDEO_ASPECT_RATIO_UNSPECIFIED तय नहीं या अज्ञात.
VIDEO_ASPECT_RATIO_WIDESCREEN वीडियो को स्ट्रेच किया गया है. साथ ही, इसके ऊपरी और निचले हिस्से को क्रॉप किया गया है.
VIDEO_ASPECT_RATIO_FIXED_16_9 वीडियो में 16:9 के तय आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) का इस्तेमाल किया जाता है.

InStreamAd

किसी इन-स्ट्रीम विज्ञापन का विवरण.

जेएसओएन के काेड में दिखाना
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
फ़ील्ड
commonInStreamAttribute

object (CommonInStreamAttribute)

विज्ञापन की सामान्य विशेषताएं.

customParameters

map (key: string, value: string)

ट्रैकिंग यूआरएल टेंप्लेट में कस्टम वैल्यू भेजने के लिए कस्टम पैरामीटर.

एक ऑब्जेक्ट, जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CommonInStreamAttribute

इन-स्ट्रीम, स्किप न किए जा सकने वाले, और बंपर विज्ञापनों के लिए सामान्य एट्रिब्यूट.

जेएसओएन के काेड में दिखाना
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
फ़ील्ड
displayUrl

string

विज्ञापन के साथ दिखने वाले वेबपेज का पता.

finalUrl

string

उस वेबपेज का यूआरएल पता जिस पर लोग विज्ञापन पर क्लिक करने के बाद पहुंचते हैं.

trackingUrl

string

ट्रैक करने के लिए, बैकग्राउंड में लोड किया गया यूआरएल पता.

actionButtonLabel

string

कॉल-टू-ऐक्शन बटन पर मौजूद टेक्स्ट.

actionHeadline

string

कॉल-टू-ऐक्शन बैनर की हेडलाइन.

video

object (YoutubeVideoDetails)

विज्ञापन का YouTube वीडियो.

companionBanner

object (ImageAsset)

वीडियो विज्ञापन के बगल में दिखने वाली इमेज.

ImageAsset

किसी इमेज एसेट का मेटा डेटा.

जेएसओएन के काेड में दिखाना
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}
फ़ील्ड
mimeType

string

इमेज एसेट का MIME टाइप.

fullSize

object (Dimensions)

इस इमेज का मेटाडेटा इसके मूल साइज़ में है.

fileSize

string (int64 format)

इमेज एसेट का बाइट में साइज़.

NonSkippableAd

स्किप न किए जा सकने वाले विज्ञापन की जानकारी.

जेएसओएन के काेड में दिखाना
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
फ़ील्ड
commonInStreamAttribute

object (CommonInStreamAttribute)

विज्ञापन की सामान्य विशेषताएं.

customParameters

map (key: string, value: string)

ट्रैकिंग यूआरएल टेंप्लेट में कस्टम वैल्यू भेजने के लिए कस्टम पैरामीटर.

एक ऑब्जेक्ट, जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

BumperAd

बंपर विज्ञापन की जानकारी.

जेएसओएन के काेड में दिखाना
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
फ़ील्ड
commonInStreamAttribute

object (CommonInStreamAttribute)

विज्ञापन की सामान्य विशेषताएं.

AudioAd

ऑडियो विज्ञापन की जानकारी.

जेएसओएन के काेड में दिखाना
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
फ़ील्ड
displayUrl

string

विज्ञापन के साथ दिखने वाले वेबपेज का पता.

finalUrl

string

उस वेबपेज का यूआरएल पता जिस पर लोग विज्ञापन पर क्लिक करने के बाद पहुंचते हैं.

trackingUrl

string

ट्रैक करने के लिए, बैकग्राउंड में लोड किया गया यूआरएल पता.

video

object (YoutubeVideoDetails)

विज्ञापन का YouTube वीडियो.

VideoDiscoveryAd

वीडियो डिस्कवरी विज्ञापन की जानकारी.

जेएसओएन के काेड में दिखाना
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
फ़ील्ड
headline

string

विज्ञापन की हेडलाइन.

description1

string

विज्ञापन की पहली टेक्स्ट लाइन.

description2

string

विज्ञापन की दूसरी टेक्स्ट लाइन.

video

object (YoutubeVideoDetails)

वह YouTube वीडियो, जिसका विज्ञापन प्रचार करता है.

thumbnail

enum (Thumbnail)

विज्ञापन में इस्तेमाल की गई थंबनेल इमेज.

थंबनेल

वीडियो डिस्कवरी विज्ञापनों में थंबनेल के संभावित विकल्प.

Enums
THUMBNAIL_UNSPECIFIED कोई जानकारी नहीं है या तय नहीं किया गया है.
THUMBNAIL_DEFAULT डिफ़ॉल्ट थंबनेल, अपने-आप जनरेट हो सकता है या उपयोगकर्ता का अपलोड किया गया हो सकता है.
THUMBNAIL_1 वीडियो से जनरेट किया गया थंबनेल 1.
THUMBNAIL_2 वीडियो से जनरेट किया गया थंबनेल 2.
THUMBNAIL_3 वीडियो से जनरेट किया गया थंबनेल 3.

VideoPerformanceAd

वीडियो परफ़ॉर्मेंस विज्ञापन की जानकारी.

जेएसओएन के काेड में दिखाना
{
  "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

उस वेबपेज का यूआरएल पता जिस पर लोग विज्ञापन पर क्लिक करने के बाद पहुंचते हैं.

trackingUrl

string

ट्रैक करने के लिए, बैकग्राउंड में लोड किया गया यूआरएल पता.

actionButtonLabels[]

string

कॉल-टू-ऐक्शन बटन पर दिखने वाली टेक्स्ट ऐसेट की सूची.

headlines[]

string

कॉल-टू-ऐक्शन बैनर पर दिखाई गई हेडलाइन की सूची.

longHeadlines[]

string

कॉल-टू-ऐक्शन बैनर पर दिखाई गई अलग हेडलाइन की सूची.

descriptions[]

string

कॉल-टू-ऐक्शन बैनर पर दिखने वाली जानकारी की सूची.

displayUrlBreadcrumb1

string

डिसप्ले यूआरएल में डोमेन के बाद पहला हिस्सा.

displayUrlBreadcrumb2

string

डिसप्ले यूआरएल में डोमेन के बाद दूसरा हिस्सा.

domain

string

डिसप्ले यूआरएल का डोमेन.

videos[]

object (YoutubeVideoDetails)

उन YouTube वीडियो ऐसेट की सूची जिनका इस्तेमाल इस विज्ञापन ने किया है.

customParameters

map (key: string, value: string)

ट्रैकिंग यूआरएल टेंप्लेट में कस्टम वैल्यू भेजने के लिए कस्टम पैरामीटर.

एक ऑब्जेक्ट, जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

companionBanners[]

object (ImageAsset)

इस विज्ञापन के साथ इस्तेमाल किए जाने वाले बैनर विज्ञापन की सूची.

AdUrl

बीकन सहित विज्ञापन से जुड़े दूसरे यूआरएल.

जेएसओएन के काेड में दिखाना
{
  "type": enum (AdUrlType),
  "url": string
}
फ़ील्ड
type

enum (AdUrlType)

विज्ञापन यूआरएल का टाइप.

url

string

यूआरएल स्ट्रिंग की वैल्यू.

AdUrlType

विज्ञापन यूआरएल के संभावित टाइप.

Enums
AD_URL_TYPE_UNSPECIFIED कोई जानकारी नहीं है या तय नहीं किया गया है.
AD_URL_TYPE_BEACON_IMPRESSION किसी क्रिएटिव का इंप्रेशन डिलीवर किए जाने पर पिंग करने के लिए 1x1 ट्रैकिंग पिक्सल.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION बड़ा किया जा सकने वाला DCM इंप्रेशन बीकन. पेश करते समय, इसे कई बीकन तक बढ़ाया जाता है.
AD_URL_TYPE_BEACON_CLICK क्लिक इवेंट ट्रिगर होने पर पिंग करने के लिए ट्रैकिंग यूआरएल.
AD_URL_TYPE_BEACON_SKIP स्किप इवेंट ट्रिगर होने पर पिंग करने वाला ट्रैकिंग यूआरएल.

तरीके

get

YouTube विज्ञापन ग्रुप का विज्ञापन दिखाता है.

list

यह YouTube विज्ञापन समूह के विज्ञापन की सूची बनाता है.