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

विज्ञापन के संसाधन का नाम.
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)

रीच के लिए इस्तेमाल किए गए, 6 सेकंड या उससे कम अवधि के स्किप न किए जा सकने वाले छोटे वीडियो विज्ञापन की जानकारी.
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

इमेज ऐसेट का एमआईएमई टाइप.
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 वीडियो से जनरेट किया गया दूसरा थंबनेल.
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

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

list

 विज्ञापन ग्रुप के विज्ञापनों की सूची दिखाता है.