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)
    }
  ],

  // 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 و حداکثر اندازه ۲۵۵ بایت کدگذاری شود.

adPolicy

object ( AdPolicy )

وضعیت تأیید سیاست تبلیغ.

entityStatus

enum ( EntityStatus )

وضعیت موجودیت تبلیغ.

adUrls[]

object ( AdUrl )

فهرست آدرس‌های اینترنتی (URL) استفاده شده توسط تبلیغ.

فیلد ad_details مربوط به یک آگهی. جزئیات آگهی.

ad_details فقط می‌تواند یکی از موارد زیر باشد:

displayVideoSourceAd

object ( DisplayVideoSourceAd )

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

mastheadAd

object ( MastheadAd )

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

inStreamAd

object ( InStreamAd )

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

nonSkippableAd

object ( NonSkippableAd )

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

bumperAd

object ( BumperAd )

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

audioAd

object ( AudioAd )

جزئیات یک تبلیغ صوتی که برای اهداف بازاریابی دسترسی استفاده می‌شود.

videoDiscoverAd

object ( VideoDiscoveryAd )

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

videoPerformanceAd

object ( VideoPerformanceAd )

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

سیاست تبلیغات

یک سیاست تبلیغاتی واحد مرتبط با یک تبلیغ گروه تبلیغاتی.

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

enum ( AdPolicyApprovalStatus )

وضعیت تأیید سیاست یک تبلیغ، که نشان‌دهنده‌ی تصمیم تأیید است.

adPolicyReviewStatus

enum ( AdPolicyReviewStatus )

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

adPolicyTopicEntry[]

object ( AdPolicyTopicEntry )

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

سیاست تبلیغاتوضعیت تأیید

وضعیت‌های احتمالی تأیید خط‌مشی تبلیغات.

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

سیاست تبلیغاتبررسیوضعیت

وضعیت‌های احتمالی بررسی سیاست تبلیغاتی.

انوم‌ها
AD_POLICY_REVIEW_STATUS_UNKNOWN ناشناخته یا نامشخص.
REVIEW_IN_PROGRESS فعلاً در دست بررسی است.
REVIEWED بررسی اولیه تکمیل شد. بررسی‌های دیگر ممکن است هنوز در حال انجام باشند.
UNDER_APPEAL برای تأیید دوباره ارسال شده یا تصمیم مربوط به خط‌مشی مورد تجدیدنظر قرار گرفته است.
ELIGIBLE_MAY_SERVE واجد شرایط تشخیص داده شده و ممکن است در حال گذراندن دوره محکومیت خود باشد. بررسی‌های بیشتر هنوز ممکن است ادامه داشته باشد.

سیاست تبلیغاتموضوعورود

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

نمایش 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 )

اطلاعات در مورد نحوه اعتراض به تصمیم سیاست.

سیاست تبلیغاتموضوعنوع ورود

تأثیرات احتمالی ارائه خدمات از یک موضوع سیاست تبلیغاتی.

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

سیاست تبلیغاتنوع تصمیم

منابع احتمالی یک تصمیم سیاسی.

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

ابزارهای اجرای سیاست تبلیغاتی

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

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

سیاست تبلیغاتموضوعشواهد

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

نمایش JSON 
{

  // Union field value can be only one of the following:
  "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 list of possible types for union field value.
}
فیلدها
value فیلد Union. شواهد برای تصمیم سیاست. value می‌تواند فقط یکی از موارد زیر باشد:
textList

object ( TextList )

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

websiteList

object ( WebsiteList )

فهرست وب‌سایت‌های مرتبط با آگهی.

httpCode

integer

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

languageCode

string

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

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

destinationTextList

object ( DestinationTextList )

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

destinationMismatch

object ( DestinationMismatch )

عدم تطابق بین آدرس‌های اینترنتی مقصد تبلیغ.

destinationNotWorking

object ( DestinationNotWorking )

اطلاعات مربوط به خطاهای HTTP یا DNS مربوط به مقصد تبلیغ.

trademark

object ( Trademark )

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

legalRemoval

object ( LegalRemoval )

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

counterfeit

object ( Counterfeit )

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

regionalRequirements

object ( RegionalRequirements )

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

لیست متن

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

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

string

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

فهرست وب‌سایت‌ها

فهرست وب‌سایت‌هایی که این سیاست را نقض کرده‌اند.

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

string

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

لیست متن مقصد

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

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

string

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

عدم تطابق مقصد

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

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

enum ( AdPolicyTopicEvidenceDestinationMismatchUrlType )

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

مثال ۱: [ DISPLAY_URL , FINAL_URL ] یعنی آدرس نمایش تبلیغ با آدرس نهایی تبلیغ مطابقت ندارد.

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

AdPolicyTopicEvidenceDestinationMismatchUrlType

انواع URL های ممکن

انوم‌ها
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN مشخص نشده یا ناشناخته است.
DISPLAY_URL آدرس اینترنتی نمایش داده شده.
FINAL_URL آدرس اینترنتی نهایی.
FINAL_MOBILE_URL آدرس اینترنتی نهایی موبایل.
TRACKING_URL آدرس اینترنتی ردیابی.
MOBILE_TRACKING_URL آدرس اینترنتی ردیابی موبایل.

مقصد کار نمی‌کند

جزئیات مربوط به خطاهای HTTP یا DNS مربوط به مقصد تبلیغ.

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

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
فیلدها
expandedUri

string

آدرس کامل که کار نمی‌کرد.

device

enum ( AdPolicyTopicEvidenceDestinationNotWorkingDeviceType )

دستگاهی که از طریق آن URL بازدید شده، منجر به خطا شده است.

lastCheckedTime

string ( Timestamp format)

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

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

reason فیلد Union. reason خطای HTTP یا DNS فقط می‌تواند یکی از موارد زیر باشد:
dnsErrorType

enum ( AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType )

نوع خطای DNS.

httpErrorCode

string ( int64 format)

کد خطای HTTP.

سیاست تبلیغاتموضوعشواهدمقصدکارنکردینوع خطای DNS

انواع خطاهای احتمالی DNS

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

سیاست تبلیغاتموضوعشواهدمقصدکارنیستنوع دستگاه

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

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

علامت تجاری

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

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

string

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

term

string

اصطلاح علامت تجاری.

countryRestrictions[]

object ( AdPolicyCriterionRestriction )

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

سیاست تبلیغاتمعیار محدودیت

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

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

string ( int64 format)

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

countryLabel

string

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

حذف قانونی

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

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

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
فیلدها
complaintType

enum ( AdPolicyTopicEvidenceLegalRemovalComplaintType )

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

countryRestrictions[]

object ( AdPolicyCriterionRestriction )

کشورهای محدود شده به دلیل حذف قانونی.

restrictedUris[]

string

آدرس‌های اینترنتی به دلیل حذف قانونی محدود شده‌اند.

type فیلد Union. جزئیات مربوط به نوع حذف قانونی. type می‌تواند فقط یکی از موارد زیر باشد:
dmca

object ( Dmca )

جزئیات مربوط به حذف قانونی بر اساس قانون DMCA.

دی‌ام‌سی‌ای

جزئیات شکایت DMCA

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

string

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

محلی-حقوقی

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

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

string

نوع قانون برای ابلاغیه قانونی.

سیاست تبلیغاتموضوع شواهدحقوقیحذفنوع شکایت

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

انوم‌ها
COPYRIGHT

حق نشر.

فقط در مورد DMCA اعمال می‌شود.

COURT_ORDER

حکم دادگاه.

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

تقلبی

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

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

string

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

الزامات منطقه‌ای

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

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

object ( RegionalRequirementsEntry )

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

الزامات منطقه‌ایورودی

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

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

string

سیاست قانونی که نقض می‌شود.

countryRestrictions[]

object ( AdPolicyCriterionRestriction )

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

محدودیت موضوع سیاست تبلیغات

جزئیات مربوط به محدودیت‌های نمایش تبلیغات.

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

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
فیلدها
constraint فیلد اتحادیه. محدودیت سرویس‌دهی. constraint می‌تواند فقط یکی از موارد زیر باشد:
countryConstraint

object ( AdPolicyCountryConstraintList )

کشورهایی که تبلیغ در آنها قابل ارائه نیست.

resellerConstraint

object ( AdPolicyResellerConstraint )

محدودیت نمایندگی فروش.

certificateMissingCountryList

object ( AdPolicyCountryConstraintList )

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

certificateDomainMismatchCountryList

object ( AdPolicyCountryConstraintList )

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

globalCertificateMissing

object ( AdPolicyGlobalCertificateMissingConstraint )

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

globalCertificateDomainMismatch

object ( AdPolicyGlobalCertificateDomainMismatchConstraint )

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

سیاست تبلیغات، فهرست محدودیت‌ها، کشور

فهرستی از کشورهایی که به دلیل محدودیت‌های سیاستی، تبلیغ در آنها قابل نمایش نیست.

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

object ( AdPolicyCriterionRestriction )

کشورهایی که تبلیغ در آنها قابل ارائه نیست.

محدودیت سیاست تبلیغات

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

موضوع سیاست به دلیل عدم تأیید وب‌سایت برای اهداف فروش مجدد، محدود شد.

سیاست تبلیغاتGlobalCertificateMissingConstraint

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

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

سیاست تبلیغاتمحدودیت عدم تطابق گواهی جهانی دامنه

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

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

سیاست تبلیغاتموضوع درخواست تجدیدنظراطلاعات

اطلاعات در مورد نحوه اعتراض به تصمیم سیاست.

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

enum ( AdPolicyAppealType )

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

سیاست تبلیغاتنوع درخواست تجدیدنظر

انواع احتمالی درخواست تجدیدنظر.

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

نمایشویدئوسورسآگهی

این تبلیغ از یک منبع خلاق در DV360 گرفته شده است.

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

string ( int64 format)

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

آگهی سرگروه

جزئیات مربوط به آگهی سربرگ.

نمایش 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 )

ویدیوی یوتیوب مورد استفاده در تبلیغ.

headline

string

تیتر آگهی.

description

string

توضیحات آگهی.

videoAspectRatio

enum ( VideoAspectRatio )

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

autoplayVideoStartMillisecond

string ( int64 format)

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

autoplayVideoDuration

string ( Duration format)

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

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

callToActionButtonLabel

string

متن روی دکمه فراخوان عمل.

callToActionFinalUrl

string

آدرس اینترنتی (URL) مقصد برای دکمه فراخوان عمل.

callToActionTrackingUrl

string

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

showChannelArt

boolean

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

companionYoutubeVideos[]

object ( YoutubeVideoDetails )

ویدیوهایی که در کنار تبلیغ اصلی در دسکتاپ ظاهر می‌شوند. نمی‌توانند بیش از دو عدد باشند.

جزئیات ویدئوی یوتیوب

جزئیات یک ویدیوی یوتیوب.

نمایش JSON 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}
فیلدها
id

string

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

unavailableReason

enum ( VideoUnavailableReason )

دلیل اینکه داده‌های ویدیویی در دسترس نیستند.

دلیل عدم دسترسی به ویدیو

دلایل احتمالی عدم دسترسی به ویدیو

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

نسبت ابعاد ویدئو

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

انوم‌ها
VIDEO_ASPECT_RATIO_UNSPECIFIED مشخص نشده یا ناشناخته است.
VIDEO_ASPECT_RATIO_WIDESCREEN ویدیو کشیده شده و بالا و پایین آن بریده شده است.
VIDEO_ASPECT_RATIO_FIXED_16_9 این ویدئو از نسبت تصویر ثابت ۱۶:۹ استفاده می‌کند.

تبلیغات درون برنامه‌ای

جزئیات مربوط به یک تبلیغ درون برنامه‌ای.

نمایش JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
فیلدها
commonInStreamAttribute

object ( CommonInStreamAttribute )

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

customParameters

map (key: string, value: string)

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

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

ویژگی CommonInStream

ویژگی‌های مشترک تبلیغات درون استریم، غیرقابل رد شدن و تبلیغات موقت.

نمایش JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
فیلدها
displayUrl

string

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

finalUrl

string

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

trackingUrl

string

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

actionButtonLabel

string

متن روی دکمه فراخوان عمل.

actionHeadline

string

تیتر بنر فراخوان عمل.

video

object ( YoutubeVideoDetails )

ویدیوی یوتیوب مربوط به این تبلیغ.

companionBanner

object ( ImageAsset )

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

تصویر دارایی

متا دیتای یک تصویر.

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

string

نوع MIME مربوط به تصویر.

fullSize

object ( Dimensions )

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

fileSize

string ( int64 format)

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

تبلیغات غیرقابل رد شدن

جزئیات مربوط به یک تبلیغ غیرقابل رد کردن.

نمایش JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
فیلدها
commonInStreamAttribute

object ( CommonInStreamAttribute )

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

customParameters

map (key: string, value: string)

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

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

بامپرآد

جزئیات مربوط به یک آگهی تبلیغاتی روی سپر خودرو.

نمایش JSON 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
فیلدها
commonInStreamAttribute

object ( CommonInStreamAttribute )

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

تبلیغات صوتی

جزئیات مربوط به یک تبلیغ صوتی.

نمایش JSON 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
فیلدها
displayUrl

string

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

finalUrl

string

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

trackingUrl

string

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

video

object ( YoutubeVideoDetails )

ویدیوی یوتیوب مربوط به این تبلیغ.

ویدیو دیسکاوری اد

جزئیات مربوط به یک تبلیغ ویدیویی Discovery.

نمایش JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
فیلدها
headline

string

تیتر آگهی.

description1

string

اولین خط متن برای تبلیغ.

description2

string

خط دوم متن برای تبلیغ.

video

object ( YoutubeVideoDetails )

ویدیوی یوتیوبی که تبلیغ آن را تبلیغ می‌کند.

thumbnail

enum ( Thumbnail )

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

تصویر بندانگشتی

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

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

عملکرد ویدیوییتبلیغ

جزئیات مربوط به یک تبلیغ ویدیویی.

نمایش 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

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

trackingUrl

string

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

actionButtonLabels[]

string

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

headlines[]

string

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

longHeadlines[]

string

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

descriptions[]

string

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

displayUrlBreadcrumb1

string

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

displayUrlBreadcrumb2

string

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

domain

string

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

videos[]

object ( YoutubeVideoDetails )

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

customParameters

map (key: string, value: string)

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

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

companionBanners[]

object ( ImageAsset )

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

ادورل

URL های اضافی مربوط به تبلیغ، از جمله بیکن ها.

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

enum ( AdUrlType )

نوع آدرس اینترنتی تبلیغ.

url

string

مقدار رشته‌ی URL.

نوع آدرس تبلیغاتی

انواع آدرس‌های اینترنتی (URL) تبلیغات ممکن.

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

روش‌ها

get

 یک تبلیغ گروه تبلیغاتی دریافت می‌کند.

list

 تبلیغات گروه‌های تبلیغاتی را فهرست می‌کند.