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.
}

string

نام منبع آگهی

string ( int64 format)

شناسه منحصر به فرد تبلیغ کننده ای که تبلیغ به آن تعلق دارد.

string ( int64 format)

شناسه منحصر به فرد آگهی. توسط سیستم تعیین شده است.

string ( int64 format)

شناسه منحصر به فرد گروه تبلیغاتی که آگهی به آن تعلق دارد.

string

نام نمایشی آگهی

باید UTF-8 با حداکثر اندازه 255 بایت کدگذاری شود.

enum ( EntityStatus )

وضعیت موجودیت آگهی.

object ( AdUrl )

لیست URL های استفاده شده توسط آگهی.

object ( DisplayVideoSourceAd )

جزئیات تبلیغی که از یک خلاقیت Display & Video 360 منشأ گرفته است.

object ( MastheadAd )

جزئیات آگهی ارائه شده در فید Home YouTube .

object ( InStreamAd )

جزئیات یک تبلیغ درون جریانی که پس از 5 ثانیه قابل رد شدن است ، برای آگاهی از نام تجاری یا رسیدن به اهداف بازاریابی استفاده می شود.

object ( NonSkippableAd )

جزئیات یک آگهی ویدیویی کوتاه غیرقابل رد شدن ، بین 6 تا 15 ثانیه، که برای رسیدن به اهداف بازاریابی استفاده می‌شود.

object ( BumperAd )

جزئیات یک آگهی ویدیویی کوتاه غیرقابل رد شدن ، برابر یا کمتر از ۶ ثانیه، که برای دسترسی استفاده می‌شود.

object ( AudioAd )

جزئیات یک آگهی صوتی که برای رسیدن به اهداف بازاریابی استفاده می شود.

object ( VideoDiscoveryAd )

جزئیات آگهی تبلیغاتی ویدیویی که در مکان‌های کشف نشان داده می‌شود.

object ( VideoPerformanceAd )

جزئیات آگهی مورد استفاده در کمپین اقدام ویدیویی برای هدایت کنش‌ها به سمت کسب و کار، خدمات یا محصول.

{
  "creativeId": string
}

string ( int64 format)

شناسه خلاقیت منبع.

{
  "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)
    }
  ]
}

object ( YoutubeVideoDetails )

ویدیوی یوتیوب که توسط تبلیغ استفاده شده است.

string

تیتر آگهی.

string

توضیحات آگهی

enum ( VideoAspectRatio )

نسبت تصویر پخش خودکار ویدیوی YouTube در مستدل.

string ( int64 format)

مقدار زمانی بر حسب میلی ثانیه که پس از آن ویدیو شروع به پخش می کند.

string ( Duration format)

مدت زمان پخش خودکار ویدیو.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

string

متن روی دکمه فراخوان برای اقدام.

string

نشانی وب مقصد برای دکمه فراخوان برای اقدام.

string

URL ردیابی دکمه فراخوان برای اقدام.

boolean

آیا برای نمایش پس‌زمینه یا بنری که در بالای صفحه YouTube ظاهر می‌شود.

object ( YoutubeVideoDetails )

ویدیوهایی که در کنار آگهی سرصفحه دسکتاپ ظاهر می شوند. نمی تواند بیشتر از دو باشد.

{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}

string

شناسه ویدیوی YouTube که در صفحه وب YouTube قابل جستجو است.

enum ( VideoUnavailableReason )

دلیل در دسترس نبودن داده های ویدیویی

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object ( CommonInStreamAttribute )

ویژگی های رایج تبلیغات

map (key: string, value: string)

پارامترهای سفارشی برای ارسال مقادیر سفارشی به الگوی URL ردیابی.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}

string

آدرس صفحه وب که همراه آگهی ظاهر می شود.

string

آدرس URL صفحه وب که افراد پس از کلیک بر روی تبلیغ به آن دسترسی پیدا می کنند.

string

آدرس URL بارگیری شده در پس‌زمینه برای اهداف ردیابی.

string

متن روی دکمه فراخوان برای اقدام.

string

تیتر بنر دعوت به اقدام.

object ( YoutubeVideoDetails )

ویدیوی یوتیوب آگهی.

object ( ImageAsset )

تصویری که در کنار آگهی ویدیویی نشان داده می شود.

{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}

string

نوع MIME دارایی تصویر.

object ( Dimensions )

فراداده این تصویر در اندازه اصلی آن.

string ( int64 format)

اندازه فایل دارایی تصویر بر حسب بایت.

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object ( CommonInStreamAttribute )

ویژگی های رایج تبلیغات

map (key: string, value: string)

پارامترهای سفارشی برای ارسال مقادیر سفارشی به الگوی URL ردیابی.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}

object ( CommonInStreamAttribute )

ویژگی های رایج تبلیغات

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}

string

آدرس صفحه وب که همراه آگهی ظاهر می شود.

string

آدرس URL صفحه وب که افراد پس از کلیک بر روی تبلیغ به آن دسترسی پیدا می کنند.

string

آدرس URL بارگیری شده در پس‌زمینه برای اهداف ردیابی.

object ( YoutubeVideoDetails )

ویدیوی یوتیوب آگهی.

{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}

string

تیتر آگهی

string

خط اول متن آگهی

string

خط دوم متن آگهی

object ( YoutubeVideoDetails )

ویدیوی YouTube که تبلیغ تبلیغ می کند.

enum ( Thumbnail )

تصویر کوچک استفاده شده در تبلیغ.

{
  "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)
    }
  ]
}

string

آدرس URL صفحه وب که افراد پس از کلیک بر روی تبلیغ به آن دسترسی پیدا می کنند.

string

آدرس URL بارگیری شده در پس‌زمینه برای اهداف ردیابی.

string

لیست دارایی های متنی که در دکمه فراخوان به اقدام نشان داده شده است.

string

لیستی از عناوین نشان داده شده در بنر دعوت به اقدام.

string

لیستی از سرفصل های تنها که در بنر دعوت به اقدام نشان داده شده است.

string

لیستی از توضیحات نشان داده شده در بنر دعوت به اقدام.

string

اولین قطعه بعد از دامنه در URL نمایش داده می شود.

string

قطعه دوم بعد از دامنه در URL نمایش داده می شود.

string

دامنه URL نمایش داده می شود.

object ( YoutubeVideoDetails )

فهرست دارایی‌های ویدیوی YouTube استفاده شده توسط این آگهی.

map (key: string, value: string)

پارامترهای سفارشی برای ارسال مقادیر سفارشی به الگوی URL ردیابی.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( ImageAsset )

لیست بنرهای همراه استفاده شده توسط این آگهی.

{
  "type": enum (AdUrlType),
  "url": string
}

enum ( AdUrlType )

نوع URL آگهی.

string

مقدار رشته URL.