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

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