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)

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

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

object (DisplayVideoSourceAd)

डिसप्ले और विज्ञापन नेटवर्क से लिए गए विज्ञापन की जानकारी 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 क्रिएटिव से लिया गया विज्ञापन.

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

string (int64 format)

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

MastheadAd

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

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)

विज्ञापन में इस्तेमाल किया गया 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 वीडियो की जानकारी.

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

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

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

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

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

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

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

string

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

fullSize

object (Dimensions)

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

fileSize

string (int64 format)

इमेज ऐसेट की फ़ाइल का साइज़ बाइट में.

NonSkippableAd

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

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

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

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

object (CommonInStreamAttribute)

सामान्य विज्ञापन एट्रिब्यूट.

AudioAd

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

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

string

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

finalUrl

string

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

trackingUrl

string

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

video

object (YoutubeVideoDetails)

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

VideoDiscoveryAd

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

JSON के काेड में दिखाना
{
  "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 वीडियो से जनरेट किया गया पहला थंबनेल.
THUMBNAIL_2 वीडियो से जनरेट किया गया थंबनेल 2.
THUMBNAIL_3 तीसरा थंबनेल, वीडियो से जनरेट किया गया.

VideoPerformanceAd

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

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

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

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

विज्ञापन से जुड़े अतिरिक्त यूआरएल, जिनमें बीकन भी शामिल हैं.

JSON के काेड में दिखाना
{
  "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 विज्ञापन ग्रुप के विज्ञापनों की सूची बनाता है.