REST Resource: advertisers.adGroupAds

संसाधन: विज्ञापन समूह विज्ञापन

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

जेएसओएन के काेड में दिखाना 
{
  "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 बड़ा किया जा सकने वाला डीसीएम इंप्रेशन बीकन. पेश करते समय, इसे कई बीकन में विस्तृत किया जाता है.
AD_URL_TYPE_BEACON_CLICK क्लिक इवेंट ट्रिगर होने पर पिंग करने के लिए ट्रैकिंग यूआरएल.
AD_URL_TYPE_BEACON_SKIP स्किप इवेंट ट्रिगर होने पर पिंग करने वाला ट्रैकिंग यूआरएल.

तरीके

get

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

list

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