REST Resource: advertisers.adGroupAds

منبع: AdGroupAd

یک آگهی تکی مرتبط با یک گروه آگهی.

نمایش JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "adPolicy": {
    object (AdPolicy)
  },
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],
  "dcmTrackingInfo": {
    object (DcmTrackingInfo)
  },
  "containsSyntheticMedia": boolean,
  "parentCreativeId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of mutually exclusive fields.
}
فیلدها
name

string

فقط خروجی. نام منبع آگهی.
advertiserId

string (int64 format)

فقط خروجی. شناسه یکتای تبلیغ‌کننده‌ای که آگهی به او تعلق دارد.
adGroupAdId

string (int64 format)

فقط خروجی. شناسه یکتای آگهی. توسط سیستم اختصاص داده شده است.
adGroupId

string (int64 format)

الزامی. تغییرناپذیر. شناسه یکتای گروه آگهی که آگهی به آن تعلق دارد.
displayName

string

الزامی. نام نمایشی آگهی.

باید با UTF-8 کدبندی شده باشد و حداکثر اندازه آن ۲۵۵ بایت باشد.
adPolicy

object (AdPolicy)

فقط خروجی. وضعیت تأیید خط‌مشی آگهی.
entityStatus

enum (EntityStatus)

الزامی. وضعیت نهاد آگهی.
adUrls[]

object (AdUrl)

فقط خروجی. فهرست نشانی‌های وب استفاده‌شده توسط آگهی.
dcmTrackingInfo

object (DcmTrackingInfo)

اختیاری. اطلاعات آگهی پیگیری DCM.

برای برداشتن اطلاعات آگهی ردیابی DCM، لطفاً این فیلد را خالی بگذارید.
containsSyntheticMedia

boolean

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

فقط باید برای آگهی‌هایی تنظیم شود که توسط تبلیغ‌کنندگان انتخاباتی تأییدشده ساخته شده‌اند. فقط برای آگهی‌های YouTube معتبر است.
parentCreativeId

string (int64 format)

فقط خروجی. شناسه طرح آگهی Display & Video 360 که برای تولید این آگهی استفاده شده است.

این فیلد فقط برای آگهی‌های تولیدشده از طرح‌آگهی‌های اختصاص‌داده‌شده به گروه آگهی ولی پر خواهد شد.
جزئیات آگهی. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
displayVideoSourceAd

object (DisplayVideoSourceAd)

فقط خروجی. جزئیات آگهی‌ای که از یک طرح آگهی Display & Video 360 گرفته شده است.
mastheadAd

object (MastheadAd)

فقط خروجی. جزئیات آگهی ارائه‌شده در فید «صفحه اصلی YouTube».
inStreamAd

object (InStreamAd)

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

object (NonSkippableAd)

فقط خروجی. جزئیات آگهی ویدیویی درون‌جاری‌سازی کوتاه ردنشدنی، بین ۶ تا ۱۵ ثانیه، که برای اهداف بازاریابی دسترسی استفاده می‌شود.
bumperAd

object (BumperAd)

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

object (AudioAd)

فقط خروجی. جزئیات آگهی صوتی استفاده‌شده برای اهداف بازاریابی دسترسی.
videoDiscoverAd

object (VideoDiscoveryAd)

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

object (VideoPerformanceAd)

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

object (DemandGenVideoAd)

اختیاری. جزئیات آگهی ویدیویی «تولید تقاضا».
demandGenImageAd

object (DemandGenImageAd)

اختیاری. جزئیات آگهی تصویری «تولید تقاضا».
demandGenProductAd

object (DemandGenProductAd)

اختیاری. جزئیات آگهی محصول «تولید تقاضا».
پایان فیلدهای متقابلاً انحصاری.

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 با پخش خودکار در Masthead.
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),
  "videoAssetId": string
}
فیلدها
id

string

فقط خروجی. شناسه ویدیو YouTube که می‌توان آن را در صفحه وب YouTube جستجو کرد.
unavailableReason

enum (VideoUnavailableReason)

فقط خروجی. دلیل دردسترس نبودن داده‌های ویدیو.
videoAssetId

string (int64 format)

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

VideoUnavailableReason

دلایل احتمالی که ممکن است یک ویدیو دردسترس نباشد.

شمارشی‌ها
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED نامشخص یا نامعلوم.
VIDEO_UNAVAILABLE_REASON_PRIVATE ویدیو خصوصی است.
VIDEO_UNAVAILABLE_REASON_DELETED ویدیو حذف شده است.

VideoAspectRatio

نسبت‌های ابعادی ممکن برای ویدیو YouTube.

شمارشی‌ها
VIDEO_ASPECT_RATIO_UNSPECIFIED مشخص‌نشده یا ناشناخته.
VIDEO_ASPECT_RATIO_WIDESCREEN ویدیو کشیده شده است و بالا و پایین آن برش خورده است.
VIDEO_ASPECT_RATIO_FIXED_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,
  "userSpecifiedTrackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
فیلدها
displayUrl

string

الزامی. نشانی صفحه وبی که با آگهی نشان داده می‌شود.
finalUrl

string

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

string

فقط خروجی. نشانی وب بارشده در پس‌زمینه برای اهداف ردیابی.

در نسخه ۴ و نسخه‌های قدیمی‌تر، این فیلد نشان‌دهنده نشانی وب ردیابی است که کاربر به‌صورت دستی مشخص کرده است. این مورد را می‌توانید در userSpecifiedTrackingUrl در نسخه ۵ پیدا کنید.
userSpecifiedTrackingUrl

string

اختیاری. نشانی وب ردیابی که کاربر به‌صورت دستی مشخص کرده است.
actionButtonLabel

string

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

اگر actionHeadline تنظیم شده باشد، باید تنظیم شود.
actionHeadline

string

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

object (YoutubeVideoDetails)

الزامی. تغییرناپذیر. ویدیو YouTube آگهی.
companionBanner

object (ImageAsset)

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

ImageAsset

فراداده دارایی تصویر.

نمایش JSON 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string,
  "assetId": string
}
فیلدها
mimeType

string

فقط خروجی. نوع MIME دارایی تصویر.
fullSize

object (Dimensions)

فقط خروجی. فراداده این تصویر در اندازه اصلی آن.
fileSize

string (int64 format)

فقط خروجی. اندازه فایل دارایی تصویری برحسب بایت.
assetId

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,
  "userSpecifiedTrackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
فیلدها
displayUrl

string

نشانی صفحه وبی که با آگهی نشان داده می‌شود.
finalUrl

string

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

string

نشانی وب بارشده در پس‌زمینه برای اهداف ردیابی.

در نسخه ۴ و نسخه‌های قدیمی‌تر، این فیلد نشان‌دهنده نشانی وب ردیابی است که کاربر به‌صورت دستی مشخص کرده است. این مورد را می‌توانید در userSpecifiedTrackingUrl در نسخه ۵ پیدا کنید.
userSpecifiedTrackingUrl

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)

تصویر کوچک استفاده‌شده در آگهی.

ریزعکس

گزینه‌های احتمالی ریزعکس در «آگهی‌های اکتشافی ویدیویی».

شمارشی‌ها
THUMBNAIL_UNSPECIFIED نامشخص یا نامعلوم.
THUMBNAIL_DEFAULT ریزعکس پیش‌فرض، می‌تواند به‌طور خودکار تولید شود یا توسط کاربر بارگذاری شود.
THUMBNAIL_1 ریزعکس ۱، تولیدشده از ویدیو.
THUMBNAIL_2 ریزعکس ۲، تولیدشده از ویدیو.
THUMBNAIL_3 ریزعکس ۳، تولیدشده از ویدیو.

VideoPerformanceAd

جزئیات آگهی عملکردی ویدیویی.

نمایش JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ],
  "businessName": string,
  "logo": {
    object (ImageAsset)
  }
}
فیلدها
finalUrl

string

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

string

فقط خروجی. نشانی وب بارشده در پس‌زمینه برای اهداف ردیابی.

در نسخه ۴ و نسخه‌های قدیمی‌تر، این فیلد نشان‌دهنده نشانی وب ردیابی است که کاربر به‌صورت دستی مشخص کرده است. این مورد را می‌توانید در userSpecifiedTrackingUrl در نسخه ۵ پیدا کنید.
userSpecifiedTrackingUrl

string

اختیاری. نشانی وب ردیابی که کاربر به‌صورت دستی مشخص کرده است.
actionButtonLabels[]

string

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

اگر headlines تنظیم شده باشد، باید تنظیم شود.
headlines[]

string

اختیاری. فهرست عنوان‌های نشان‌داده‌شده در برنمای دعوت به اقدام.
longHeadlines[]

string

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

باید تنظیم شود، مگراینکه lineItemType مورد خطی اصلی LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE باشد، که دراین‌صورت این فیلد نمی‌تواند تنظیم شود.
descriptions[]

string

اختیاری. فهرست شرح‌های نشان‌داده‌شده در برنمای دعوت به اقدام.

باید تنظیم شود، مگراینکه lineItemType مورد خطی اصلی LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE باشد، که دراین‌صورت این فیلد نمی‌تواند تنظیم شود.
displayUrlBreadcrumb1

string

اختیاری. اولین بخش بعداز دامنه در نشانی وب نمایشی.
displayUrlBreadcrumb2

string

اختیاری. بخش دوم بعداز دامنه در نشانی وب نمایشی.

فقط درصورتی می‌توان تنظیم کرد که displayUrlBreadcrumb1 نیز تنظیم شده باشد.
domain

string

فقط خروجی. دامنه نشانی وب نمایش‌داده‌شده.
videos[]

object (YoutubeVideoDetails)

الزامی. فهرست دارایی‌های ویدیویی YouTube که این آگهی از آن‌ها استفاده می‌کند.
customParameters

map (key: string, value: string)

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

شیئی که حاوی فهرستی از جفت‌های "key": value است. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
companionBanners[]

object (ImageAsset)

اختیاری. فهرست برنماهای همپا که این آگهی استفاده می‌کند.
businessName

string

اختیاری. نام کسب‌وکار نشان‌داده‌شده در آگهی.

این تنظیم الزامی است، مگراینکه مقدار پیش‌فرضی در سطح تبلیغ‌کننده تنظیم شده باشد. اگر تنظیم نشود، مقدار پیش‌فرض اعمال خواهد شد.

DemandGenVideoAd

جزئیات آگهی ویدیویی «تولید تقاضا».

نمایش JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
فیلدها
finalUrl

string

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

string

فقط خروجی. نشانی وب بارشده در پس‌زمینه برای اهداف ردیابی.
userSpecifiedTrackingUrl

string

اختیاری. نشانی وب ردیابی که کاربر به‌صورت دستی مشخص کرده است.
callToAction

enum (CallToAction)

الزامی. دکمه دعوت به اقدام نشان‌داده‌شده در آگهی.

مقادیر پشتیبانی‌شده عبارت‌اند از:

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

الزامی. فهرست عنوان‌های نشان‌داده‌شده در آگهی.
longHeadlines[]

string

الزامی. فهرست عنوان‌های طولانی نشان‌داده‌شده در آگهی.
descriptions[]

string

الزامی. فهرست شرح‌های نشان‌داده‌شده در آگهی.
displayUrlBreadcrumb1

string

اختیاری. اولین بخش بعداز دامنه در نشانی وب نمایشی.
displayUrlBreadcrumb2

string

اختیاری. بخش دوم بعداز دامنه در نشانی وب نمایشی.
videos[]

object (YoutubeVideoDetails)

الزامی. فهرست دارایی‌های ویدیویی YouTube که این آگهی از آن‌ها استفاده می‌کند.
customParameters

map (key: string, value: string)

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

شیئی که حاوی فهرستی از جفت‌های "key": value است. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
companionBanner

object (ImageAsset)

اختیاری. برنمای همپا که این آگهی استفاده می‌کند.
finalMobileUrl

string

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

string

اختیاری. پسوندی که به نشانی‌های وب صفحه مقصد اضافه می‌شود.
businessName

string

اختیاری. نام کسب‌وکار نشان‌داده‌شده در آگهی.

این تنظیم الزامی است، مگراینکه مقدار پیش‌فرضی در سطح تبلیغ‌کننده تنظیم شده باشد. اگر تنظیم نشود، مقدار پیش‌فرض اعمال خواهد شد.

CallToAction

مقادیر احتمالی دعوت به اقدام برای آگهی‌های «محصول/ویدیویی تولید تقاضا».

شمارشی‌ها
CALL_TO_ACTION_UNSPECIFIED مشخص‌نشده یا ناشناخته.
AUTOMATED خودکارسازی‌شده.
LEARN_MORE بیشتر بدانید.
GET_QUOTE مظنه قیمت بگیرید.
APPLY_NOW اکنون درخواست کنید.
SIGN_UP ثبت‌نام کنید.
CONTACT_US با ما تماس بگیرید.
SUBSCRIBE مشترک شدن ضربه بزنید.
DOWNLOAD بارگیری کنید.
BOOK_NOW اکنون رزرو کنید.
SHOP_NOW اکنون بخرید.
BUY_NOW اکنون بخرید.
DONATE_NOW اکنون اهدا کنید.
ORDER_NOW اکنون سفارش دهید.
PLAY_NOW اکنون بازی کنید.
SEE_MORE بیشتر ببینید.
START_NOW اکنون شروع شود ضربه بزنید.
VISIT_SITE بازدید از سایت.
WATCH_NOW اکنون تماشا کنید.

DemandGenImageAd

جزئیات آگهی تصویری «تولید تقاضا».

نمایش JSON 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
فیلدها
finalUrl

string

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

string

فقط خروجی. نشانی وب بارشده در پس‌زمینه برای اهداف ردیابی.
userSpecifiedTrackingUrl

string

اختیاری. نشانی وب ردیابی که کاربر به‌صورت دستی مشخص کرده است.
callToAction

string

الزامی. دکمه دعوت به اقدام نشان‌داده‌شده در آگهی.
headlines[]

string

الزامی. فهرست عنوان‌های نشان‌داده‌شده در آگهی.
descriptions[]

string

الزامی. فهرست شرح‌های نشان‌داده‌شده در آگهی.
customParameters

map (key: string, value: string)

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

شیئی که حاوی فهرستی از جفت‌های "key": value است. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
finalMobileUrl

string

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

string

اختیاری. پسوندی که به نشانی‌های وب صفحه مقصد اضافه می‌شود.
businessName

string

اختیاری. نام کسب‌وکار نشان‌داده‌شده در آگهی.

این تنظیم الزامی است، مگراینکه مقدار پیش‌فرضی در سطح تبلیغ‌کننده تنظیم شده باشد. اگر تنظیم نشود، مقدار پیش‌فرض اعمال خواهد شد.
marketingImages[]

object (ImageAsset)

فهرست تصاویر بازاریابی نشان‌داده‌شده در آگهی.
squareMarketingImages[]

object (ImageAsset)

فهرست تصاویر بازاریابی مربعی که در آگهی نشان داده می‌شود.
portraitMarketingImages[]

object (ImageAsset)

فهرست تصاویر بازاریابی عمودی نشان‌داده‌شده در آگهی.
logoImages[]

object (ImageAsset)

فهرست تصاویر نشان‌واره نمایش‌داده‌شده در آگهی.

این تنظیم الزامی است، مگراینکه مقدار پیش‌فرضی در سطح تبلیغ‌کننده تنظیم شده باشد. اگر تنظیم نشود، مقدار پیش‌فرض اعمال خواهد شد.

DemandGenCarouselAd

جزئیات آگهی گردونه‌ای «تولید تقاضا».

نمایش JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
فیلدها
finalUrl

string

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

string

الزامی. عنوان آگهی.
description

string

الزامی. شرح آگهی.
cards[]

object (CarouselCard)

الزامی. فهرست کارت‌های نشان‌داده‌شده در آگهی.
finalUrlSuffix

string

اختیاری. پسوندی که به نشانی‌های وب صفحه مقصد اضافه می‌شود.
trackingUrl

string

فقط خروجی. نشانی وب بارشده در پس‌زمینه برای اهداف ردیابی.
userSpecifiedTrackingUrl

string

اختیاری. نشانی وب ردیابی که کاربر به‌صورت دستی مشخص کرده است.
businessName

string

اختیاری. نام کسب‌وکار نشان‌داده‌شده در آگهی.

این تنظیم الزامی است، مگراینکه مقدار پیش‌فرضی در سطح تبلیغ‌کننده تنظیم شده باشد. اگر تنظیم نشود، مقدار پیش‌فرض اعمال خواهد شد.
customParameters

map (key: string, value: string)

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

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

CarouselCard

جزئیات کارت گردونه‌ای «تولید تقاضا».

نمایش JSON 
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
فیلدها
finalUrl

string

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

string

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

string

الزامی. عنوان کارت.
callToAction

string

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

باید ۱۰ نویسه یا کمتر باشد.
marketingImage

object (ImageAsset)

اختیاری. تصویر بازاریابی نشان‌داده‌شده در کارت.
squareMarketingImage

object (ImageAsset)

اختیاری. تصویر بازاریابی مربعی که در کارت نشان داده می‌شود.
portraitMarketingImage

object (ImageAsset)

اختیاری. تصویر بازاریابی عمودی نشان‌داده‌شده در کارت.

DemandGenProductAd

جزئیات آگهی محصول «تولید تقاضا».

نمایش JSON 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
فیلدها
finalUrl

string

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

string

الزامی. عنوان آگهی.
description

string

الزامی. شرح آگهی.
finalUrlSuffix

string

اختیاری. پسوندی که به نشانی‌های وب صفحه مقصد اضافه می‌شود.
callToAction

enum (CallToAction)

الزامی. دکمه دعوت به اقدام نشان‌داده‌شده در آگهی.

مقادیر پشتیبانی‌شده عبارت‌اند از:

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

فقط خروجی. نشانی وب بارشده در پس‌زمینه برای اهداف ردیابی.
userSpecifiedTrackingUrl

string

اختیاری. نشانی وب ردیابی که کاربر به‌صورت دستی مشخص کرده است.
businessName

string

اختیاری. نام کسب‌وکار نشان‌داده‌شده در آگهی.

این تنظیم الزامی است، مگراینکه مقدار پیش‌فرضی در سطح تبلیغ‌کننده تنظیم شده باشد. اگر تنظیم نشود، مقدار پیش‌فرض اعمال خواهد شد.
customParameters

map (key: string, value: string)

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

شیئی که حاوی فهرستی از جفت‌های "key": value است. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
displayUrlBreadcrumb1

string

اختیاری. اولین بخش بعداز دامنه در نشانی وب نمایشی.
displayUrlBreadcrumb2

string

اختیاری. بخش دوم بعداز دامنه در نشانی وب نمایشی.

AdPolicy

یک خط‌مشی آگهی مرتبط با آگهی گروه آگهی.

نمایش JSON 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
فیلدها
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

وضعیت تأیید خط‌مشی آگهی که نشان‌دهنده تصمیم تأیید است.
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

وضعیت بازبینی خط‌مشی آگهی که نشان می‌دهد آگهی درحال‌حاضر در کدام مرحله از فرایند بازبینی قرار دارد.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

ورودی‌های هر موضوع خط‌مشی که به‌عنوان مرتبط با آگهی شناسایی شده است. هر ورودی شامل موضوع، سطح محدودیت، و راهنمایی درباره نحوه رفع مشکلات خط‌مشی است.

AdPolicyApprovalStatus

وضعیت‌های ممکن برای تأیید خط‌مشی آگهی.

شمارشی‌ها
AD_POLICY_APPROVAL_STATUS_UNKNOWN نامشخص یا تعیین‌نشده.
DISAPPROVED ارائه نخواهد شد.
APPROVED_LIMITED با محدودیت ارائه خواهد شد.
APPROVED بدون محدودیت ارائه خواهد شد.
AREA_OF_INTEREST_ONLY در کشورهای موردهدف ارائه نخواهد شد، اما ممکن است برای کاربرانی که اطلاعاتی درباره کشورهای موردهدف جستجو می‌کنند ارائه شود.

AdPolicyReviewStatus

وضعیت‌های ممکن بازبینی خط‌مشی آگهی.

شمارشی‌ها
AD_POLICY_REVIEW_STATUS_UNKNOWN نامشخص یا تعیین‌نشده.
REVIEW_IN_PROGRESS درحال‌حاضر دردست بازبینی است.
REVIEWED بازبینی اولیه کامل شد. بازبینی‌های دیگر ممکن است هنوز درحال انجام باشد.
UNDER_APPEAL برای تأیید دوباره ارسال شده است یا برای تصمیم‌گیری درباره خط‌مشی پژوهش‌خواهی شده است.
ELIGIBLE_MAY_SERVE واجدشرایط تشخیص داده شده است و ممکن است درحال ارائه باشد. ممکن است بازبینی‌های بیشتری انجام شود.

AdPolicyTopicEntry

ورودی‌ای که توضیح می‌دهد چگونه آگهی‌ای به‌عنوان مرتبط با خط‌مشی آگهی شناسایی شده است.

نمایش JSON 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
فیلدها
policyTopic

string

موضوع خط‌مشی.

نمونه‌ها شامل «علامت‌های تجاری»، «الکل»، و غیره است.
policyLabel

string

نوشتار برچسب بومی‌سازی‌شده برای خط‌مشی.

نمونه‌ها شامل «علامت تجاری در نوشتار»، «حاوی الکل»، و غیره است.
policyTopicDescription

string

شرح خلاصه کوتاهی از موضوع خط‌مشی.
policyTopicType

enum (AdPolicyTopicEntryType)

نحوه تأثیرگذاری بر ارائه آگهی به‌دلیل ارتباط با موضوع خط‌مشی آگهی.
policyDecisionType

enum (AdPolicyDecisionType)

منبع تصمیم تابع خط‌مشی.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

ابزار اجرای خط‌مشی که در بازبینی خط‌مشی استفاده شده است.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

شواهدی که در تصمیم تابع خط‌مشی استفاده شده است.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

محدودیت‌های ارائه مربوط به تصمیم تابع خط‌مشی.
appealInfo

object (AdPolicyTopicAppealInfo)

اطلاعاتی درباره نحوه پژوهش‌خواهی برای تصمیم تابع خط‌مشی.

AdPolicyTopicEntryType

تأثیرات احتمالی موضوع خط‌مشی آگهی بر ارائه آگهی.

شمارشی‌ها
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN نامشخص یا تعیین‌نشده.
PROHIBITED منبع ارائه نخواهد شد.
FULLY_LIMITED این منبع در همه کشورهای موردهدف ارائه نخواهد شد.
LIMITED این منبع نمی‌تواند در برخی کشورها ارائه شود.
DESCRIPTIVE منبع می‌تواند ارائه شود.
BROADENING منبع می‌تواند ارائه شود و ممکن است فراتر از پوشش عادی ارائه شود.
AREA_OF_INTEREST_ONLY منبع برای همه کشورهای موردهدف محدود شده است، اما ممکن است برای کاربرانی که اطلاعاتی درباره کشورهای موردهدف جستجو می‌کنند ارائه شود.

AdPolicyDecisionType

منابع احتمالی تصمیم تابع خط‌مشی.

شمارشی‌ها
AD_POLICY_DECISION_TYPE_UNKNOWN نامشخص یا تعیین‌نشده.
PURSUANT_TO_NOTICE تصمیم براساس ابلاغیه حقوقی، حکم دادگاه، یا شکایت مالک محتوای علامت تجاری و غیره گرفته شده است.
GOOGLE_INVESTIGATION این تصمیم ازسوی تحقیقات تحت مالکیت Google گرفته شده است.

AdPolicyEnforcementMeans

ابزار احتمالی اجرای خط‌مشی که در بازبینی خط‌مشی استفاده شده است.

شمارشی‌ها
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN نامشخص یا تعیین‌نشده.
AUTOMATED فرایند اجرا کاملاً خودکار بود.
HUMAN_REVIEW یک انسان به‌طور جزئی یا کامل در فرایند اجرای تصمیم دخیل بوده است.

AdPolicyTopicEvidence

اطلاعات شواهد استفاده‌شده در تصمیم تابع خط‌مشی.

نمایش JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of mutually exclusive fields.
}
فیلدها
شواهد مربوط به تصمیم تابع خط‌مشی. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
textList

object (TextList)

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

object (WebsiteList)

فهرست وب‌سایت‌های پیوندشده با آگهی.
httpCode

integer

کد HTTP که هنگام خزیدن نشانی وب نهایی برگردانده شد.
languageCode

string

زبانی که تشخیص داده شده است آگهی به آن نوشته شده است.

این فیلد از برچسب‌های زبان IETF، مانند «en-US» استفاده می‌کند.
destinationTextList

object (DestinationTextList)

نوشتار موجود در مقصد آگهی که باعث نقض خط‌مشی می‌شود.
destinationMismatch

object (DestinationMismatch)

عدم تطابق بین نشانی‌های وب مقصد آگهی.
destinationNotWorking

object (DestinationNotWorking)

اطلاعات مربوط به خطاهای HTTP یا ساناد مرتبط با مقصد آگهی.
trademark

object (Trademark)

اصطلاحات علامت تجاری که باعث نقض خط‌مشی شده‌اند.
legalRemoval

object (LegalRemoval)

اجرای مقررات مربوط به قانون که باعث نقض خط‌مشی شده است.
counterfeit

object (Counterfeit)

اجرای خط‌مشی کالای تقلبی که باعث نقض خط‌مشی شده است.
regionalRequirements

object (RegionalRequirements)

اجرای پیش‌گیرانه «اعتماد و ایمنی» که باعث نقض خط‌مشی شده است.
پایان فیلدهای متقابلاً انحصاری.

TextList

فهرستی از بخش‌های نوشتاری که خط‌مشی را نقض کرده‌اند.

نمایش JSON 
{
  "texts": [
    string
  ]
}
فیلدها
texts[]

string

تکه‌های نوشتار از منبعی که باعث یافتن خط‌مشی شده است.

WebsiteList

فهرستی از وب‌سایت‌هایی که خط‌مشی را نقض کرده‌اند.

نمایش JSON 
{
  "websites": [
    string
  ]
}
فیلدها
websites[]

string

وب‌سایت‌هایی که باعث یافتن خط‌مشی شده‌اند.

DestinationTextList

فهرستی از نوشتار مقصد که خط‌مشی را نقض کرده است.

نمایش JSON 
{
  "destinationTexts": [
    string
  ]
}
فیلدها
destinationTexts[]

string

نوشتار مقصد که باعث یافتن خط‌مشی شده است.

DestinationMismatch

جزئیات مربوط به عدم تطابق بین انواع نشانی وب مقصد.

نمایش JSON 
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
فیلدها
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

مجموعه نشانی‌های وبی که مطابقت ندارند. این فهرست می‌تواند شامل یک یا چند نوع شناسه منبع یکسان باشد.

مثال ۱: [DISPLAY_URL، FINAL_URL] یعنی نشانی وب نمایش‌داده‌شده آگهی با نشانی وب نهایی آگهی مطابقت ندارد.

مثال ۲: [FINAL_URL] یعنی نشانی وب نهایی آگهی با نشانی وب خزیده مطابقت ندارد، که این مورد هم به‌عنوان عدم تطابق مقصد درنظر گرفته می‌شود.

AdPolicyTopicEvidenceDestinationMismatchUrlType

انواع نشانی وب ممکن.

شمارشی‌ها
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN مشخص‌نشده یا ناشناخته.
DISPLAY_URL نشانی وب نمایش‌داده‌شده.
FINAL_URL نشانی وب نهایی.
FINAL_MOBILE_URL نشانی وب تلفن همراه مقصد.
TRACKING_URL نشانی وب پیگیری.
MOBILE_TRACKING_URL نشانی وب پیگیری تلفن همراه.

DestinationNotWorking

جزئیات مربوط به خطاهای HTTP یا ساناد مرتبط با مقصد آگهی.

نمایش JSON 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of mutually exclusive fields.
}
فیلدها
expandedUri

string

نشانی وب کاملی که کار نمی‌کند.
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

دستگاهی که بازدید از نشانی وب در آن منجر به خطا شده است.
lastCheckedTime

string (Timestamp format)

آخرین باری که این خطا هنگام پیمایش به نشانی وب دیده شد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولیدشده همیشه Z-نرمال‌شده است و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".
خطای HTTP یا ساناد. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

نوع خطای ساناد.
httpErrorCode

string (int64 format)

کد خطای HTTP.
پایان فیلدهای متقابلاً انحصاری.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

انواع خطای ساناد احتمالی.

شمارشی‌ها
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN مشخص‌نشده یا ناشناخته.
HOSTNAME_NOT_FOUND هنگام واکشی صفحه مقصد، نام میزبان در ساناد پیدا نشد.
GOOGLE_CRAWLER_DNS_ISSUE Google هنگام برقراری ارتباط با ساناد نتوانست در صفحه مقصد بخزد.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

دستگاه‌های احتمالی که هنگام بازدید از نشانی وب با خطا مواجه شده‌اند.

شمارشی‌ها
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN مشخص‌نشده یا ناشناخته.
DESKTOP رایانه رومیزی.
ANDROID دستگاه Android.
IOS دستگاه iOS.

علامت تجاری

اصطلاحات علامت تجاری که باعث نقض خط‌مشی شده‌اند.

نمایش JSON 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
فیلدها
owner

string

مالک محتوای علامت تجاری.
term

string

واژه علامت تجاری.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

کشورهایی که نقض خط‌مشی در آن‌ها روی داده است.

AdPolicyCriterionRestriction

نشان‌دهنده محدودیت کشور است.

نمایش JSON 
{
  "countryCriterionId": string,
  "countryLabel": string
}
فیلدها
countryCriterionId

string (int64 format)

شناسه معیار کشور.
countryLabel

string

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

LegalRemoval

اجرای مقررات مربوط به قانون، از DMCA یا مقررات قانونی محلی.

نمایش JSON 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of mutually exclusive fields.
}
فیلدها
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

نوع شکایتی که باعث برداشتن محتوا به دلایل حقوقی شده است.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

کشورهایی که به‌دلیل برداشتن محتوا به دلایل قانونی محدود شده‌اند.
restrictedUris[]

string

نشانی‌های وب به‌دلیل برداشتن محتوا به دلایل قانونی محدود شده‌اند.
جزئیات مربوط به نوع برداشتن محتوا به دلایل قانونی. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
dmca

object (Dmca)

جزئیات مربوط به برداشتن محتوا به دلایل قانونی طبق مقررات «قانون حق نشر هزاره دیجیتال».
پایان فیلدهای متقابلاً انحصاری.

قانون حق نشر هزاره دیجیتال

جزئیات شکایت تحت «قانون حق نشر هزاره دیجیتال».

نمایش JSON 
{
  "complainant": string
}
فیلدها
complainant

string

نهادی که شکایت حقوقی را مطرح کرده است.

LocalLegal

جزئیات مقررات قانونی محلی.

نمایش JSON 
{
  "lawType": string
}
فیلدها
lawType

string

نوع قانون برای اخطار حقوقی.

AdPolicyTopicEvidenceLegalRemovalComplaintType

انواع شکایت‌های احتمالی برای برداشتن محتوا به دلایل حقوقی.

شمارشی‌ها
COPYRIGHT

حق نشر.

فقط برای «قانون حق نشر هزاره دیجیتال» اعمال می‌شود.
COURT_ORDER

حکم دادگاه.

فقط برای موارد قانونی محلی اعمال می‌شود.

جعل

جزئیات مربوط به اجرای خط‌مشی کالای تقلبی که باعث نقض خط‌مشی شده است.

نمایش JSON 
{
  "owners": [
    string
  ]
}
فیلدها
owners[]

string

مالکان محتوا یا محصولی که شکایت کرده‌اند.

RegionalRequirements

اجرای پیش‌گیرانه «اعتماد و ایمنی» (T&S) برای خط‌مشی‌هایی که هدفشان رسیدگی به الزامات منطقه‌ای است. این مورد به‌عنوان تحقیقات تحت مالکیت Google درنظر گرفته می‌شود نه اعلان مقررات، زیرا اجرای پیشگیرانه «شرایط خدمات» است.

نمایش JSON 
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
فیلدها
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

فهرست الزامات منطقه‌ای.

RegionalRequirementsEntry

جزئیات نقض قانونی منطقه‌ای در سطح خط‌مشی.

نمایش JSON 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
فیلدها
legalPolicy

string

خط‌مشی قانونی که نقض شده است.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

کشورهایی که به‌دلیل خط‌مشی حقوقی محدود شده‌اند.

AdPolicyTopicConstraint

جزئیات مربوط به محدودیت‌های ارائه آگهی.

نمایش JSON 
{
  "requestCertificateFormLink": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of mutually exclusive fields.
}
فیلدها
محدودیت ارائه. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
countryConstraint

object (AdPolicyCountryConstraintList)

کشورهایی که آگهی نمی‌تواند در آن‌ها ارائه شود.
resellerConstraint

object (AdPolicyResellerConstraint)

محدودیت شرکت واسطه.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

کشورهایی که برای ارائه آگهی در آن‌ها گواهینامه لازم است.
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

کشورهایی که دامنه منبع تحت پوشش گواهی‌های مرتبط با آن نیست.
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

برای ارائه در هر کشوری گواهینامه لازم است.
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

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

AdPolicyCountryConstraintList

فهرستی از کشورهایی که آگهی به‌دلیل محدودیت‌های خط‌مشی نمی‌تواند در آن‌ها ارائه شود.

نمایش JSON 
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
فیلدها
countries[]

object (AdPolicyCriterionRestriction)

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

AdPolicyResellerConstraint

این نوع فیلدی ندارد.

موضوع خط‌مشی به‌دلیل رد شدن وب‌سایت برای اهداف بازفروش محدود شد.

AdPolicyGlobalCertificateMissingConstraint

این نوع فیلدی ندارد.

برای ارائه در هر کشوری گواهینامه لازم است.

AdPolicyGlobalCertificateDomainMismatchConstraint

این نوع فیلدی ندارد.

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

AdPolicyTopicAppealInfo

اطلاعاتی درباره نحوه پژوهش‌خواهی برای تصمیم تابع خط‌مشی.

نمایش JSON 
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
فیلدها
appealType

enum (AdPolicyAppealType)

آیا می‌توان برای این تصمیم ازطریق ابزار ارسال فرم پژوهش‌خواهی یا فرم پژوهش‌خواهی درخواست تجدیدنظر کرد یا نه.

AdPolicyAppealType

انواع احتمالی پژوهش‌خواهی.

شمارشی‌ها
AD_POLICY_APPEAL_TYPE_UNKNOWN نامشخص یا تعیین‌نشده.
SELF_SERVICE_APPEAL می‌توانید ازطریق ابزار ارسال فرم پژوهش‌خواهی برای این تصمیم پژوهش‌خواهی کنید.
APPEAL_FORM بااستفاده از فرم پژوهش‌خواهی می‌توان برای این تصمیم پژوهش‌خواهی کرد.

AdUrl

نشانی‌های وب اضافی مرتبط با آگهی، ازجمله فانوس‌ها.

نمایش JSON 
{
  "type": enum (AdUrlType),
  "url": string
}
فیلدها
type

enum (AdUrlType)

نوع نشانی وب آگهی.
url

string

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

AdUrlType

انواع ممکن نشانی وب آگهی.

شمارشی‌ها
AD_URL_TYPE_UNSPECIFIED نامشخص یا نامعلوم.
AD_URL_TYPE_BEACON_IMPRESSION پیکسل رهگیری ۱x۱ برای پینگ کردن هنگام ارائه ظهور طرح آگهی.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION نشان‌فرست تعداد دفعات بازدید DCM ازهم بازشدنی. در زمان ارائه، به چندین فانوسک گسترش می‌یابد.
AD_URL_TYPE_BEACON_CLICK نشانی وب پیگیری برای پینگ کردن وقتی رویداد کلیک راه‌اندازی می‌شود.
AD_URL_TYPE_BEACON_SKIP نشانی وب پیگیری برای پینگ کردن هنگام راه‌اندازی رویداد رد شدن.

DcmTrackingInfo

جزئیات مربوط به ردگیری DCM.

نمایش JSON 
{
  "placementId": string,
  "trackingAdId": string,
  "creativeId": string
}
فیلدها
placementId

string (int64 format)

الزامی. شناسه جایگاه DCM.
trackingAdId

string (int64 format)

الزامی. شناسه آگهی پیگیری DCM.
creativeId

string (int64 format)

الزامی. شناسه طرح‌آگهی DCM.

روش‌ها

create

 آگهی گروه آگهی ایجاد می‌کند.

delete

 آگهی گروه آگهی را حذف می‌کند.

get

 آگهی گروه آگهی را دریافت می‌کند.

list

 آگهی‌های گروه آگهی را فهرست می‌کند.

patch

 آگهی گروه آگهی را به‌روز می‌کند.