REST Resource: customers.ads

FinalAppUrl

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

نمایندگی JSON
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
زمینه های
osType

enum ( AppUrlOperatingSystemType )

سیستم عامل هدف این URL. ضروری.

url

string

URL پیوند عمیق برنامه. پیوندهای عمیق مکانی را در برنامه مشخص می کنند که با محتوایی که می خواهید نشان دهید مطابقت دارد و باید به شکل {scheme}://{host_path} باشد. این طرح مشخص می کند که کدام برنامه باز شود. برای برنامه خود، می توانید از یک طرح سفارشی استفاده کنید که با نام برنامه شروع می شود. میزبان و مسیر مکان منحصر به فرد را در برنامه ای که محتوای شما در آن وجود دارد مشخص می کند. مثال: "exampleapp://productid_1234". ضروری.

AppUrlOperatingSystemType

سیستم عامل

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
IOS سیستم عامل Apple IOS.
ANDROID سیستم عامل اندروید.

پارامتر سفارشی

نقشه‌برداری که می‌تواند توسط برچسب‌های پارامتر سفارشی در trackingUrlTemplate ، finalUrls یا mobile_final_urls استفاده شود.

نمایندگی JSON
{
  "key": string,
  "value": string
}
زمینه های
key

string

کلیدی که با نام تگ پارامتر مطابقت دارد.

value

string

مقداری که باید جایگزین شود.

نوع تبلیغ

انواع احتمالی یک آگهی

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

TEXT_AD تبلیغ یک تبلیغ متنی است.
EXPANDED_TEXT_AD آگهی یک تبلیغ متنی گسترده است.
EXPANDED_DYNAMIC_SEARCH_AD تبلیغ یک تبلیغ جستجوی پویا گسترده است.
HOTEL_AD آگهی آگهی هتل است.
SHOPPING_SMART_AD این تبلیغ یک تبلیغ خرید هوشمند است.
SHOPPING_PRODUCT_AD آگهی یک آگهی خرید استاندارد است.
VIDEO_AD تبلیغ یک تبلیغ ویدیویی است.
IMAGE_AD این تبلیغ یک تبلیغ تصویری است.
RESPONSIVE_SEARCH_AD تبلیغ یک آگهی جستجوی واکنشگرا است.
LEGACY_RESPONSIVE_DISPLAY_AD این تبلیغ یک تبلیغ نمایشی پاسخگو قدیمی است.
APP_AD تبلیغ یک تبلیغ اپلیکیشن است.
LEGACY_APP_INSTALL_AD این تبلیغ یک تبلیغ نصب برنامه قدیمی است.
RESPONSIVE_DISPLAY_AD تبلیغ یک تبلیغ نمایشی واکنش گرا است.
LOCAL_AD آگهی یک آگهی محلی است.
HTML5_UPLOAD_AD این تبلیغ یک آگهی آپلود نمایشی با نوع محصول HTML5_UPLOAD_AD است.
DYNAMIC_HTML5_AD این تبلیغ یک آگهی آپلود نمایشی با یکی از انواع محصول DYNAMIC_HTML5_* است.
APP_ENGAGEMENT_AD تبلیغ یک تبلیغ تعامل با اپلیکیشن است.
SHOPPING_COMPARISON_LISTING_AD این آگهی یک آگهی فهرست مقایسه خرید است.
VIDEO_BUMPER_AD تبلیغ ویدیویی بامپر.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD تبلیغ ویدیویی غیرقابل رد شدن در جریان.
VIDEO_OUTSTREAM_AD تبلیغ ویدیویی خارج از جریان
VIDEO_TRUEVIEW_IN_STREAM_AD تبلیغ ویدیویی TrueView در جریان.
VIDEO_RESPONSIVE_AD تبلیغ ویدئویی واکنشگرا
SMART_CAMPAIGN_AD تبلیغات کمپین هوشمند
CALL_AD آگهی تماس بگیرید.
APP_PRE_REGISTRATION_AD آگهی پیش ثبت نام جهانی برنامه.
IN_FEED_VIDEO_AD تبلیغ ویدیویی درون فید.
DISCOVERY_MULTI_ASSET_AD تبلیغ چند دارایی Discovery.
TRAVEL_AD آگهی سفر.
DISCOVERY_VIDEO_RESPONSIVE_AD تبلیغ پاسخگو ویدیوی اکتشافی.
DEMAND_GEN_PRODUCT_AD تبلیغ محصول نسل تقاضا

دستگاه

دستگاه‌های Google Ads را برای هدف‌یابی برمی‌شمارد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
MOBILE دستگاه های تلفن همراه با مرورگرهای کامل.
TABLET تبلت با مرورگر کامل
DESKTOP کامپیوترها
CONNECTED_TV تلویزیون های هوشمند و کنسول های بازی.
OTHER انواع دستگاه های دیگر

UrlCollection

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

نمایندگی JSON
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
زمینه های
finalUrls[]

string

لیستی از URL های نهایی ممکن

finalMobileUrls[]

string

لیستی از URL های نهایی تلفن همراه.

urlCollectionId

string

شناسه منحصر به فرد برای این نمونه UrlCollection.

trackingUrlTemplate

string

قالب URL برای ساخت URL ردیابی.

SystemManagedResourceSource

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
AD_VARIATIONS آگهی آزمایشی تغییرات تبلیغاتی ایجاد شده.

TextAdInfo

یک تبلیغ متنی

نمایندگی JSON
{
  "headline": string,
  "description1": string,
  "description2": string
}
زمینه های
headline

string

تیتر آگهی.

description1

string

خط اول توضیحات آگهی.

description2

string

خط دوم توضیحات آگهی.

ExpandedTextAdInfo

یک تبلیغ متنی گسترده

نمایندگی JSON
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
زمینه های
headlinePart1

string

قسمت اول تیتر آگهی.

headlinePart2

string

قسمت دوم تیتر آگهی.

headlinePart3

string

قسمت سوم تیتر آگهی.

description

string

توضیحات آگهی

description2

string

شرح دوم آگهی.

path1

string

متنی که می تواند در کنار URL نمایش داده شده تبلیغ ظاهر شود.

path2

string

متن اضافی که می تواند در کنار URL نمایش داده شده آگهی ظاهر شود.

CallAdInfo

یک تبلیغ تماس

نمایندگی JSON
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
زمینه های
countryCode

string

کد کشور در آگهی

phoneNumber

string

شماره تلفن در آگهی

businessName

string

نام تجاری در آگهی

headline1

string

تیتر اول آگهی

headline2

string

عنوان دوم در آگهی

description1

string

خط اول توضیحات آگهی.

description2

string

خط دوم توضیحات آگهی.

callTracked

boolean

فعال کردن ردیابی تماس برای خلاق. فعال کردن ردیابی تماس، تبدیل تماس را نیز فعال می کند.

disableCallConversion

boolean

غیرفعال کردن تبدیل تماس برای خلاق. اگر روی true تنظیم شود، حتی زمانی که callTracked true باشد، تبدیل تماس را غیرفعال می کند. اگر callTracked false باشد، این فیلد نادیده گرفته می شود.

phoneNumberVerificationUrl

string

URL مورد استفاده برای تأیید شماره تلفن.

conversionAction

string

عمل تبدیل برای نسبت دادن تبدیل تماس به. اگر تنظیم نشده باشد، از یک اقدام تبدیل پیش‌فرض استفاده می‌شود. این فیلد فقط در صورتی اثر می‌گذارد که callTracked روی true تنظیم شده باشد. در غیر این صورت این فیلد نادیده گرفته می شود.

conversionReportingState

enum ( CallConversionReportingState )

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

path1

string

قسمت اول متنی که می توان به URL موجود در آگهی اضافه کرد. اختیاری.

path2

string

قسمت دوم متن که می تواند به URL موجود در آگهی اضافه شود. این فیلد فقط زمانی قابل تنظیم است که path1 نیز تنظیم شده باشد. اختیاری.

CallConversionReportingState

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
DISABLED اقدام تبدیل تماس غیرفعال است.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION اقدام تبدیل تماس از نوع تبدیل تماس تنظیم شده در سطح حساب استفاده می کند.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION اقدام تبدیل تماس از نوع تبدیل تماس تنظیم شده در سطح منبع (فقط تبلیغات/افزونه‌های تماس) استفاده می‌کند.

ExpandedDynamicSearchAdInfo

یک تبلیغ جستجوی پویا گسترده

نمایندگی JSON
{
  "description": string,
  "description2": string
}
زمینه های
description

string

توضیحات آگهی

description2

string

شرح دوم آگهی.

HotelAdInfo

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

آگهی هتل

ShoppingSmartAdInfo

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

یک آگهی خرید هوشمند

ShoppingProductAdInfo

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

یک آگهی خرید استاندارد

ImageAdInfo

یک تبلیغ تصویری

نمایندگی JSON
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "imageAsset": {
    object (AdImageAsset)
  },
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
زمینه های
mimeType

enum ( MimeType )

نوع میم تصویر.

pixelWidth

string ( int64 format)

عرض تصویر بر حسب پیکسل.

pixelHeight

string ( int64 format)

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

imageUrl

string

URL تصویر در اندازه کامل.

previewPixelWidth

string ( int64 format)

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

previewPixelHeight

string ( int64 format)

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

previewImageUrl

string

URL تصویر اندازه پیش نمایش.

name

string

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

image میدان اتحادیه تصویری که از آن ImageAd ایجاد می شود. این را می توان به یکی از دو روش مشخص کرد. 1. یک منبع MediaFile موجود. 2. داده های تصویر خام به صورت بایت. image می تواند تنها یکی از موارد زیر باشد:
imageAsset

object ( AdImageAsset )

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

data

string ( bytes format)

داده های تصویر خام به صورت بایت

رشته ای با کد base64.

adIdToCopyImageFrom

string ( int64 format)

شناسه آگهی برای کپی کردن تصویر.

MimeType

نوع میم

Enums
UNSPECIFIED نوع mime مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

IMAGE_JPEG نوع MIME تصویر/jpeg.
IMAGE_GIF نوع MIME تصویر/گیف.
IMAGE_PNG نوع MIME تصویر/png.
FLASH نوع MIME برنامه/x-shockwave-flash.
TEXT_HTML نوع MIME متن/html.
PDF نوع MIME برنامه/pdf.
MSWORD نوع MIME برنامه/msword.
MSEXCEL نوع MIME برنامه/vnd.ms-excel.
RTF نوع MIME برنامه/rtf.
AUDIO_WAV نوع MIME صدا/wav.
AUDIO_MP3 نوع MIME صدا/mp3.
HTML5_AD_ZIP نوع MIME برنامه/x-html5-ad-zip.

AdImageAsset

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

نمایندگی JSON
{
  "asset": string
}
زمینه های
asset

string

نام منبع دارایی این تصویر.

VideoAdInfo

یک تبلیغ ویدیویی

نمایندگی JSON
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
زمینه های
video

object ( AdVideoAsset )

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

format فیلد اتحادیه طرح فرمت خاص برای فرمت های مختلف ویدئویی. format فقط می تواند یکی از موارد زیر باشد:
inStream

object ( VideoTrueViewInStreamAdInfo )

قالب تبلیغ ویدیویی TrueView در جریان.

bumper

object ( VideoBumperInStreamAdInfo )

باپر ویدیویی قالب تبلیغ در جریان.

outStream

object ( VideoOutstreamAdInfo )

فرمت تبلیغ ویدیویی خارج از جریان.

nonSkippable

object ( VideoNonSkippableInStreamAdInfo )

فرمت تبلیغات درون جریانی ویدیویی غیرقابل رد شدن.

inFeed

object ( InFeedVideoAdInfo )

قالب تبلیغات ویدیویی درون فید.

AdVideoAsset

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

نمایندگی JSON
{
  "asset": string
}
زمینه های
asset

string

نام منبع دارایی این ویدیو.

VideoTrueViewInStreamAdInfo

نمایش قالب تبلیغ ویدیویی TrueView در جریان (تبلیغی که در حین پخش ویدیو، اغلب در ابتدا نشان داده می‌شود، که دکمه پرش را چند ثانیه بعد از ویدیو نشان می‌دهد).

نمایندگی JSON
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
زمینه های
actionButtonLabel

string

برچسب روی دکمه CTA (Call-to-Action) کاربر را به URL نهایی تبلیغ ویدیویی می برد. برای کمپین های اکشن TrueView مورد نیاز است، در غیر این صورت اختیاری است.

actionHeadline

string

متن اضافی با دکمه CTA (Call-to-Action) نمایش داده می شود تا زمینه را ارائه دهد و کلیک روی دکمه را تشویق کند.

companionBanner

object ( AdImageAsset )

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

VideoBumperInStreamAdInfo

نمایش فرمت آگهی ویدیویی بامپر در جریان (تبلیغ ویدیویی بسیار کوتاه و غیرقابل رد شدن در جریان).

نمایندگی JSON
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
زمینه های
companionBanner

object ( AdImageAsset )

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

actionButtonLabel

string

برچسب روی دکمه «Call To Action» کاربر را به نشانی اینترنتی نهایی آگهی ویدیویی می برد.

actionHeadline

string

متن اضافی با دکمه CTA (Call-to-Action) نمایش داده می شود تا زمینه را ارائه دهد و کلیک روی دکمه را تشویق کند.

VideoOutstreamAdInfo

نمایش فرمت تبلیغ ویدیویی خارج از جریان (آگهی در کنار فید با پخش خودکار، بدون صدا نشان داده می شود).

نمایندگی JSON
{
  "headline": string,
  "description": string
}
زمینه های
headline

string

تیتر آگهی.

description

string

خط توضیحات

VideoNonSkippableInStreamAdInfo

نمایش فرمت تبلیغ ویدیویی غیرقابل رد شدن در جریان (آگهی ویدیویی غیرقابل رد شدن در جریان 15 ثانیه).

نمایندگی JSON
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
زمینه های
companionBanner

object ( AdImageAsset )

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

actionButtonLabel

string

برچسب روی دکمه «Call To Action» کاربر را به نشانی اینترنتی نهایی آگهی ویدیویی می برد.

actionHeadline

string

متن اضافی با دکمه "Call To Action" نمایش داده می شود تا زمینه را ارائه دهد و کلیک روی دکمه را تشویق کند.

InFeedVideoAdInfo

نمایش فرمت تبلیغات ویدیویی In-feed.

نمایندگی JSON
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
زمینه های
headline

string

تیتر آگهی.

description1

string

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

description2

string

خط متن دوم برای آگهی.

thumbnail

enum ( VideoThumbnail )

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

تصویر کوچک ویدیو

Enum انواع احتمالی یک تصویر کوچک ویدیو را فهرست می کند.

Enums
UNSPECIFIED نوع آن مشخص نشده است.
UNKNOWN مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است.
DEFAULT_THUMBNAIL تصویر کوچک پیش فرض می تواند به صورت خودکار تولید یا توسط کاربر آپلود شود.
THUMBNAIL_1 تصویر بندانگشتی 1، ایجاد شده از ویدیو.
THUMBNAIL_2 تصویر بندانگشتی 2، ایجاد شده از ویدیو.
THUMBNAIL_3 تصویر بند انگشتی 3، ایجاد شده از ویدیو.

VideoResponsiveAdInfo

یک تبلیغ ویدئویی واکنشگرا.

نمایندگی JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
زمینه های
headlines[]

object ( AdTextAsset )

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

longHeadlines[]

object ( AdTextAsset )

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

descriptions[]

object ( AdTextAsset )

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

callToActions[]

object ( AdTextAsset )

فهرست دارایی های متنی که برای دکمه استفاده می شود، به عنوان مثال، دکمه "Call To Action". در حال حاضر، تنها یک مقدار برای دکمه پشتیبانی می شود.

videos[]

object ( AdVideoAsset )

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

companionBanners[]

object ( AdImageAsset )

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

breadcrumb1

string

قسمت اول متنی که با URL نمایش داده شده در آگهی ظاهر می شود.

breadcrumb2

string

قسمت دوم متنی که با URL نمایش داده شده در آگهی ظاهر می شود.

AdTextAsset

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

نمایندگی JSON
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
زمینه های
pinnedField

enum ( ServedAssetFieldType )

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

assetPerformanceLabel

enum ( AssetPerformanceLabel )

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

policySummaryInfo

object ( AdAssetPolicySummary )

خلاصه خط مشی این دارایی متن.

text

string

متن دارایی

ServedAssetFieldType

انواع فیلد دارایی ممکن

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

HEADLINE_1 دارایی در عنوان 1 استفاده شده است.
HEADLINE_2 دارایی در عنوان 2 استفاده شده است.
HEADLINE_3 دارایی در عنوان 3 استفاده شده است.
DESCRIPTION_1 دارایی در توضیح 1 استفاده شده است.
DESCRIPTION_2 دارایی در شرح 2 استفاده شده است.
HEADLINE دارایی در یک عنوان استفاده شد. فقط در صورتی از این مورد استفاده کنید که فقط یک عنوان در آگهی وجود داشته باشد. در غیر این صورت، از شماره های HEADLINE_1، HEADLINE_2 یا HEADLINE_3 استفاده کنید
HEADLINE_IN_PORTRAIT دارایی به عنوان عنوان در تصویر پرتره استفاده شد.
LONG_HEADLINE دارایی در یک عنوان طولانی استفاده شده است (در MultiAssetResponsiveAd استفاده شده است).
DESCRIPTION دارایی در توضیحات استفاده شد. فقط در صورتی از این مورد استفاده کنید که فقط یک توضیح در آگهی وجود داشته باشد. در غیر این صورت، از فهرست DESCRIPTION_1 یا DESCRIPTION_@ استفاده کنید
DESCRIPTION_IN_PORTRAIT دارایی به عنوان توضیحات در تصویر پرتره استفاده شد.
BUSINESS_NAME_IN_PORTRAIT دارایی به عنوان نام تجاری در تصویر پرتره استفاده شد.
BUSINESS_NAME دارایی به عنوان نام تجاری استفاده شد.
MARKETING_IMAGE دارایی به عنوان تصویر بازاریابی استفاده شد.
MARKETING_IMAGE_IN_PORTRAIT این دارایی به عنوان یک تصویر بازاریابی در تصویر پرتره استفاده شد.
SQUARE_MARKETING_IMAGE دارایی به عنوان یک تصویر بازاریابی مربعی استفاده شد.
PORTRAIT_MARKETING_IMAGE این دارایی به عنوان یک تصویر بازاریابی پرتره استفاده شد.
CALL_TO_ACTION دارایی به عنوان یک فراخوان برای اقدام استفاده شد.
YOU_TUBE_VIDEO این دارایی به عنوان یک ویدیوی YouTube استفاده شد.
CALL این دارایی به عنوان تماس استفاده می شود.
MOBILE_APP این دارایی به عنوان یک برنامه تلفن همراه استفاده می شود.
CALLOUT این دارایی به عنوان فراخوان استفاده می شود.
STRUCTURED_SNIPPET این دارایی به عنوان یک قطعه ساختاریافته استفاده می شود.
PRICE این دارایی به عنوان قیمت استفاده می شود.
PROMOTION این دارایی به عنوان تبلیغ استفاده می شود.
AD_IMAGE این دارایی به عنوان تصویر استفاده می شود.
LEAD_FORM دارایی به عنوان فرم سرب استفاده می شود.

Asset PerformanceLabel

Enum برچسب های عملکرد احتمالی یک دارایی را توصیف می کند که معمولاً در زمینه یک پیوند محاسبه می شود.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
PENDING این دارایی هنوز هیچ اطلاعات عملکردی ندارد. این ممکن است به این دلیل باشد که هنوز در حال بررسی است.
LEARNING دارایی شروع به دریافت نمایش کرده است، اما آمارها از نظر آماری به اندازه کافی قابل توجه نیستند تا برچسب عملکرد دارایی را دریافت کنند.
LOW دارایی با بدترین عملکرد
GOOD دارایی هایی با عملکرد خوب
BEST دارایی با بهترین عملکرد

AdAssetPolicySummary

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

نمایندگی JSON
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
زمینه های
policyTopicEntries[]

object ( PolicyTopicEntry )

فهرست یافته های خط مشی برای این دارایی.

reviewStatus

enum ( PolicyReviewStatus )

جایی که در فرآیند بررسی این دارایی است.

approvalStatus

enum ( PolicyApprovalStatus )

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

PolicyTopicEntry

یافتن خط مشی پیوست شده به یک منبع (به عنوان مثال، خط مشی الکل مرتبط با سایتی که الکل می فروشد).

هر PolicyTopicEntry یک موضوع دارد که نشان‌دهنده خط‌مشی تبلیغاتی خاصی است که ورودی درباره آن است و یک نوع برای نشان دادن تأثیری که ورودی بر ارائه خواهد داشت. ممکن است به صورت اختیاری یک یا چند مدرک داشته باشد که دلیل این یافته را نشان دهد. همچنین ممکن است به صورت اختیاری یک یا چند محدودیت داشته باشد که جزئیاتی را در مورد نحوه محدود کردن خدمات ارائه می دهد.

نمایندگی JSON
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
زمینه های
type

enum ( PolicyTopicEntryType )

تأثیر منفی یا مثبتی را که این خط‌مشی بر ارائه خواهد داشت، شرح می‌دهد.

evidences[]

object ( PolicyTopicEvidence )

اطلاعات اضافی که یافتن خط مشی را توضیح می دهد (به عنوان مثال، نام تجاری برای یافتن علامت تجاری).

constraints[]

object ( PolicyTopicConstraint )

نشان می دهد که چگونه خدمت به این منبع ممکن است تحت تأثیر قرار گیرد (به عنوان مثال، خدمت نکردن در یک کشور).

topic

string

موضوع خط مشی این یافته به آن اشاره دارد. به عنوان مثال، "ALCOHOL"، "TRADEMARKS_IN_AD_TEXT"، یا "DESTINATION_NOT_WORKING". مجموعه موضوعات احتمالی خط مشی برای یک نسخه API خاص ثابت نیست و ممکن است در هر زمان تغییر کند.

PolicyTopicEntryType

انواع ورودی موضوع خط مشی ممکن

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

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

PolicyTopicEvidence

اطلاعات اضافی که یک یافته خط مشی را توضیح می دهد.

نمایندگی JSON
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
زمینه های
value فیلد اتحادیه اطلاعات شواهد خاص بسته به نوع شواهد. value فقط می تواند یکی از موارد زیر باشد:
websiteList

object ( WebsiteList )

لیست وب سایت های مرتبط با این منبع.

textList

object ( TextList )

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

languageCode

string

زبانی که منبع شناسایی شد که با آن نوشته شده است. این یک برچسب زبان IETF مانند "en-US" است.

destinationTextList

object ( DestinationTextList )

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

destinationMismatch

object ( DestinationMismatch )

عدم تطابق بین مقصد URL های یک منبع.

destinationNotWorking

object ( DestinationNotWorking )

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

لیست وب سایت

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

نمایندگی JSON
{
  "websites": [
    string
  ]
}
زمینه های
websites[]

string

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

TextList

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

نمایندگی JSON
{
  "texts": [
    string
  ]
}
زمینه های
texts[]

string

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

DestinationTextList

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

نمایندگی JSON
{
  "destinationTexts": [
    string
  ]
}
زمینه های
destinationTexts[]

string

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

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

شواهد عدم تطابق بین URL های یک منبع.

نمایندگی JSON
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
زمینه های
urlTypes[]

enum ( PolicyTopicEvidenceDestinationMismatchUrlType )

مجموعه URL هایی که با یکدیگر مطابقت نداشتند.

PolicyTopicEvidenceDestinationMismatchUrlType

شواهد موضوع خط مشی احتمالی عدم تطابق نوع نشانی وب مقصد.

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

DISPLAY_URL نشانی اینترنتی نمایشگر
FINAL_URL آدرس نهایی.
FINAL_MOBILE_URL آدرس نهایی موبایل
TRACKING_URL الگوی URL ردیابی، با آدرس دسکتاپ جایگزین شده است.
MOBILE_TRACKING_URL الگوی آدرس اینترنتی ردیابی، با آدرس اینترنتی تلفن همراه جایگزین شده است.

DestinationNotWorking

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

نمایندگی JSON
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
زمینه های
device

enum ( PolicyTopicEvidenceDestinationNotWorkingDevice )

نوع دستگاهی که نتوانست URL را بارگیری کند.

expandedUrl

string

URL کامل که کار نکرد.

lastCheckedDateTime

string

زمانی که URL آخرین بار بررسی شد. قالب "YYYY-MM-DD HH:MM:SS" است. مثال‌ها: "2018-03-05 09:15:00" یا "2018-02-01 14:34:30"

reason میدانی اتحادیه . دلیل یافتن خط‌مشی DESTINATION_NOT_WORKING را نشان می‌دهد. reason می تواند تنها یکی از موارد زیر باشد:
dnsErrorType

enum ( PolicyTopicEvidenceDestinationNotWorkingDnsErrorType )

نوع خطای DNS.

httpErrorCode

string ( int64 format)

کد خطای HTTP

PolicyTopicEvidenceDestinationNotWorkingDevice

مبحث احتمالی خط مشی شواهد مقصد دستگاه ها کار نمی کند.

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

DESKTOP صفحه فرود در دستگاه دسکتاپ کار نمی کند.
ANDROID صفحه فرود در دستگاه Android کار نمی کند.
IOS صفحه فرود در دستگاه iOS کار نمی کند.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

مقصد شواهد موضوع خط مشی احتمالی که کار نمی کند انواع خطای DNS.

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

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

PolicyTopicConstraint

تأثیری را که ورودی موضوع خط‌مشی بر ارائه خواهد داشت، توضیح می‌دهد.

نمایندگی JSON
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
زمینه های
value فیلد اتحادیه اطلاعات خاص در مورد محدودیت value فقط می تواند یکی از موارد زیر باشد:
countryConstraintList

object ( CountryConstraintList )

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

resellerConstraint

object ( ResellerConstraint )

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

certificateMissingInCountryList

object ( CountryConstraintList )

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

certificateDomainMismatchInCountryList

object ( CountryConstraintList )

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

CountryConstraintList

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

نمایندگی JSON
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
زمینه های
countries[]

object ( CountryConstraint )

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

totalTargetedCountries

integer

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

کشور محدودیت

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

نمایندگی JSON
{
  "countryCriterion": string
}
زمینه های
countryCriterion

string

نام منبع ثابت هدف جغرافیایی کشوری که خدمات در آن محدود شده است.

محدودیت Reseller

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

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

PolicyReviewStatus

وضعیت های احتمالی بررسی خط مشی

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

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

وضعیت تأیید سیاست

وضعیت های احتمالی تایید خط مشی هنگامی که چندین وضعیت تأیید موجود باشد، شدیدترین مورد استفاده خواهد شد. ترتیب شدت DISAPPROVED، AREA_OF_INTEREST_ONLY، APPROVED_LIMITED و APPROVED است.

Enums
UNSPECIFIED هیچ مقداری مشخص نشده است.
UNKNOWN

مقدار دریافتی در این نسخه مشخص نیست.

این یک مقدار فقط پاسخگویی است.

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

ResponsiveSearchAdInfo

یک تبلیغ جستجوی واکنشگرا

تبلیغات جستجوی واکنشگرا به شما امکان می دهد تبلیغی ایجاد کنید که برای نمایش متن بیشتر و پیام های مرتبط تر به مشتریان شما سازگار باشد. هنگام ایجاد یک تبلیغ جستجوی واکنشگرا، تیترها و توضیحات متعددی وارد کنید، و با گذشت زمان، Google Ads به طور خودکار ترکیب های مختلف را آزمایش می کند و یاد می گیرد که کدام ترکیب ها بهترین عملکرد را دارند. با تطبیق محتوای تبلیغ خود برای مطابقت بیشتر با عبارات جستجوی مشتریان بالقوه، تبلیغات جستجوی پاسخگو ممکن است عملکرد کمپین شما را بهبود بخشد.

اطلاعات بیشتر در https://support.google.com/google-ads/answer/7684791

نمایندگی JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
زمینه های
headlines[]

object ( AdTextAsset )

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

descriptions[]

object ( AdTextAsset )

فهرست دارایی های متن برای توضیحات هنگامی که تبلیغ ارائه می شود، توضیحات از این لیست انتخاب می شود.

path1

string

قسمت اول متنی که می توان به URL موجود در آگهی اضافه کرد.

path2

string

قسمت دوم متن که می تواند به URL موجود در آگهی اضافه شود. این فیلد فقط زمانی قابل تنظیم است که path1 نیز تنظیم شده باشد.

LegacyResponsiveDisplayAdInfo

یک تبلیغ نمایشی واکنشگرا قدیمی. تبلیغات از این نوع در رابط کاربری Google Ads با عنوان "تبلیغات پاسخگو" شناخته می شوند.

نمایندگی JSON
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
زمینه های
formatSetting

enum ( DisplayAdFormatSetting )

مشخص می کند که تبلیغ در چه قالبی ارائه می شود. پیش فرض ALL_FORMATS است.

shortHeadline

string

نسخه کوتاه تیتر آگهی.

longHeadline

string

نسخه طولانی تیتر آگهی.

description

string

توضیحات آگهی

businessName

string

نام تجاری در آگهی

allowFlexibleColor

boolean

رضایت تبلیغ کننده برای اجازه دادن به رنگ انعطاف پذیر. در صورت صحت، آگهی ممکن است در صورت لزوم با رنگ های مختلف ارائه شود. در صورت نادرست بودن، آگهی با رنگ های مشخص شده یا رنگ خنثی ارائه می شود. مقدار پیش فرض true است . اگر mainColor و accentColor تنظیم نشده باشند باید درست باشد.

accentColor

string

رنگ تاکیدی تبلیغ به صورت هگزا دسیمال، به عنوان مثال، #ffffff برای رنگ سفید. اگر یکی از mainColor و accentColor تنظیم شده باشد، دیگری نیز مورد نیاز است.

mainColor

string

رنگ اصلی تبلیغ به صورت هگزادسیمال، به عنوان مثال، #ffffff برای سفید. اگر یکی از mainColor و accentColor تنظیم شده باشد، دیگری نیز مورد نیاز است.

callToActionText

string

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

logoImage

string

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

squareLogoImage

string

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

marketingImage

string

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

squareMarketingImage

string

نام منبع MediaFile تصویر بازاریابی مربعی مورد استفاده در آگهی.

pricePrefix

string

پیشوند قبل از قیمت به عنوان مثال، "به اندازه پایین".

promoText

string

متن تبلیغاتی مورد استفاده برای قالب‌های پویا تبلیغات واکنش‌گرا. به عنوان مثال "ارسال رایگان دو روزه".

DisplayAdFormatSetting

تنظیمات قالب تبلیغات نمایشی را بر می شمارد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
ALL_FORMATS متن، تصویر و فرمت های بومی.
NON_NATIVE فرمت های متن و تصویر
NATIVE قالب بومی، برای مثال، رندر قالب توسط ناشر کنترل می شود نه توسط Google.

AppAdInfo

یک تبلیغ اپلیکیشن

نمایندگی JSON
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
زمینه های
mandatoryAdText

object ( AdTextAsset )

متن آگهی اجباری

headlines[]

object ( AdTextAsset )

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

descriptions[]

object ( AdTextAsset )

فهرست دارایی های متن برای توضیحات هنگامی که تبلیغ ارائه می شود، توضیحات از این لیست انتخاب می شود.

images[]

object ( AdImageAsset )

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

youtubeVideos[]

object ( AdVideoAsset )

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

html5MediaBundles[]

object ( AdMediaBundleAsset )

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

AdMediaBundleAsset

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

نمایندگی JSON
{
  "asset": string
}
زمینه های
asset

string

نام منبع دارایی این بسته رسانه.

LegacyAppInstallAdInfo

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

نمایندگی JSON
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
زمینه های
appStore

enum ( LegacyAppInstallAdAppStore )

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

appId

string

شناسه اپلیکیشن موبایل

headline

string

تیتر آگهی.

description1

string

اولین خط توضیحات آگهی.

description2

string

خط دوم توضیحات آگهی.

LegacyAppInstallAdAppStore

فروشگاه برنامه در آگهی نصب برنامه قدیمی تایپ کنید.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
APPLE_APP_STORE اپل آیتونز.
GOOGLE_PLAY گوگل پلی.
WINDOWS_STORE فروشگاه ویندوز.
WINDOWS_PHONE_STORE فروشگاه ویندوز فون.
CN_APP_STORE این برنامه در یک فروشگاه برنامه چینی میزبانی می شود.

ResponsiveDisplayAdInfo

یک تبلیغ نمایشی واکنشگرا

نمایندگی JSON
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
زمینه های
marketingImages[]

object ( AdImageAsset )

تصاویر بازاریابی برای استفاده در تبلیغات. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 600x314 است و نسبت تصویر باید 1.91:1 (+-1%) باشد. حداقل یک marketingImage مورد نیاز است. در ترکیب با squareMarketingImages ، حداکثر 15 عدد است.

squareMarketingImages[]

object ( AdImageAsset )

تصاویر بازاریابی مربعی برای استفاده در تبلیغات. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 300x300 است و نسبت تصویر باید 1:1 (+-1%) باشد. حداقل یک marketingImage مربعی مورد نیاز است. در ترکیب با marketingImages ، حداکثر 15 عدد است.

logoImages[]

object ( AdImageAsset )

تصاویر لوگو برای استفاده در تبلیغات انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 512x128 است و نسبت تصویر باید 4:1 (+-1%) باشد. در ترکیب با squareLogoImages ، حداکثر 5 است.

squareLogoImages[]

object ( AdImageAsset )

تصاویر آرم مربعی برای استفاده در تبلیغات. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 128x128 است و نسبت تصویر باید 1:1 (+-1%) باشد. همراه با logoImages ، حداکثر 5 است.

headlines[]

object ( AdTextAsset )

سرفصل های کوتاه فرمت آگهی. حداکثر طول 30 کاراکتر است. حداقل 1 و حداکثر 5 عنوان را می توان مشخص کرد.

longHeadline

object ( AdTextAsset )

یک عنوان با فرمت طولانی مورد نیاز. حداکثر طول 90 کاراکتر است.

descriptions[]

object ( AdTextAsset )

متن های توصیفی برای آگهی. حداکثر طول 90 کاراکتر است. حداقل 1 و حداکثر 5 عنوان را می توان مشخص کرد.

youtubeVideos[]

object ( AdVideoAsset )

ویدیوهای اختیاری YouTube برای آگهی. حداکثر 5 ویدیو را می توان مشخص کرد.

formatSetting

enum ( DisplayAdFormatSetting )

مشخص می کند که تبلیغ در چه قالبی ارائه می شود. پیش فرض ALL_FORMATS است.

controlSpec

object ( ResponsiveDisplayAdControlSpec )

مشخصات برای کنترل های خلاقانه مختلف.

businessName

string

تبلیغ کننده / نام تجاری. حداکثر عرض نمایش 25 است.

mainColor

string

رنگ اصلی تبلیغ به صورت هگزادسیمال، به عنوان مثال، #ffffff برای سفید. اگر یکی از mainColor و accentColor تنظیم شده باشد، دیگری نیز مورد نیاز است.

accentColor

string

رنگ تاکیدی تبلیغ به صورت هگزا دسیمال، به عنوان مثال، #ffffff برای رنگ سفید. اگر یکی از mainColor و accentColor تنظیم شده باشد، دیگری نیز مورد نیاز است.

allowFlexibleColor

boolean

رضایت تبلیغ کننده برای اجازه دادن به رنگ انعطاف پذیر. در صورت صحت، آگهی ممکن است در صورت لزوم با رنگ های مختلف ارائه شود. در صورت نادرست بودن، آگهی با رنگ های مشخص شده یا رنگ خنثی ارائه می شود. مقدار پیش فرض true است . اگر mainColor و accentColor تنظیم نشده باشند باید درست باشد.

callToActionText

string

متن دعوت به اقدام برای تبلیغ. حداکثر عرض نمایش 30 است.

pricePrefix

string

پیشوند قبل از قیمت به عنوان مثال، "به اندازه پایین".

promoText

string

متن تبلیغاتی مورد استفاده برای قالب‌های پویا تبلیغات واکنش‌گرا. به عنوان مثال "ارسال رایگان دو روزه".

ResponsiveDisplayAdControlSpec

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

نمایندگی JSON
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
زمینه های
enableAssetEnhancements

boolean

اینکه آیا تبلیغ‌کننده ویژگی بهبود دارایی را انتخاب کرده است یا خیر.

enableAutogenVideo

boolean

اینکه آیا تبلیغ‌کننده ویژگی ویدیوی تولید خودکار را انتخاب کرده است یا خیر.

LocalAdInfo

یک تبلیغ محلی

نمایندگی JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
زمینه های
headlines[]

object ( AdTextAsset )

فهرست دارایی های متن برای سرفصل ها. هنگامی که تبلیغ ارائه می شود، سرفصل ها از این لیست انتخاب می شوند. حداقل 1 و حداکثر 5 عنوان باید مشخص شود.

descriptions[]

object ( AdTextAsset )

فهرست دارایی های متن برای توضیحات هنگامی که تبلیغ ارائه می شود، توضیحات از این لیست انتخاب می شود. حداقل 1 و حداکثر 5 توصیف باید مشخص شود.

callToActions[]

object ( AdTextAsset )

فهرست دارایی‌های متنی برای دعوت به اقدام. هنگامی که تبلیغ ارائه می شود، دعوت به اقدام از این لیست انتخاب می شود. حداقل 1 و حداکثر 5 دعوت به اقدام باید مشخص شود.

marketingImages[]

object ( AdImageAsset )

فهرست دارایی های تصویر بازاریابی که ممکن است همراه با آگهی نمایش داده شوند. تصاویر باید 314x600 پیکسل یا 320x320 پیکسل باشند. حداقل 1 و حداکثر 20 دارایی تصویر باید مشخص شود.

logoImages[]

object ( AdImageAsset )

فهرست دارایی های تصویر لوگو که ممکن است همراه با آگهی نمایش داده شود. اندازه تصاویر باید 128x128 پیکسل باشد و از 120 کیلوبایت بیشتر نباشد. حداقل 1 و حداکثر 5 دارایی تصویر باید مشخص شود.

videos[]

object ( AdVideoAsset )

فهرست دارایی‌های ویدیوی YouTube که ممکن است همراه با آگهی نمایش داده شوند. حداقل 1 و حداکثر 20 دارایی ویدیو باید مشخص شود.

path1

string

قسمت اول متن اختیاری که می تواند به URL موجود در آگهی اضافه شود.

path2

string

قسمت دوم متن اختیاری که می تواند به URL موجود در آگهی اضافه شود. این قسمت فقط در صورت تنظیم path1 قابل تنظیم است.

DisplayUploadAdInfo

یک نوع عمومی از آگهی نمایشگر. قالب AD دقیق توسط قسمت displayUploadProductType کنترل می شود ، که تعیین می کند چه نوع داده هایی باید با AD گنجانده شود.

نمایندگی JSON
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
زمینه های
displayUploadProductType

enum ( DisplayUploadProductType )

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

Union Field media_asset . داده های دارایی که تبلیغ را تشکیل می دهند. media_asset فقط می تواند یکی از موارد زیر باشد:
mediaBundle

object ( AdMediaBundleAsset )

دارایی بسته نرم افزاری رسانه ای که در تبلیغ استفاده می شود. برای کسب اطلاعات در مورد بسته رسانه ای برای html5_upload_ad ، به https://support.google.com/google-ads/answer/1722096 بسته های رسانه ای که بخشی از انواع محصولات پویا هستند ، مراجعه کنید و از فرمت خاصی استفاده کنید که باید از طریق طراح وب Google ایجاد شود . برای کسب اطلاعات بیشتر به https://support.google.com/webdesigner/answer/7543898 مراجعه کنید.

DisplayUploadproductType

انواع محصول بارگذاری نمایش را نشان می دهد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
HTML5_UPLOAD_AD تبلیغ بارگذاری HTML5. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد.
DYNAMIC_HTML5_EDUCATION_AD آگهی آموزش HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین آموزشی قابل استفاده است.
DYNAMIC_HTML5_FLIGHT_AD تبلیغ پرواز HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین پرواز قابل استفاده است.
DYNAMIC_HTML5_HOTEL_RENTAL_AD هتل پویا HTML5 و آگهی اجاره. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کارزار هتل قابل استفاده است.
DYNAMIC_HTML5_JOB_AD آگهی شغلی HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین شغلی قابل استفاده است.
DYNAMIC_HTML5_LOCAL_AD تبلیغات محلی HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین محلی قابل استفاده است.
DYNAMIC_HTML5_REAL_ESTATE_AD آگهی املاک و مستغلات پویا HTML5. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین املاک و مستغلات قابل استفاده است.
DYNAMIC_HTML5_CUSTOM_AD آگهی سفارشی HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین سفارشی قابل استفاده است.
DYNAMIC_HTML5_TRAVEL_AD آگهی سفر HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین مسافرتی قابل استفاده است.
DYNAMIC_HTML5_HOTEL_AD آگهی هتل HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کارزار هتل قابل استفاده است.

AppEngagementAdInfo

تبلیغات نامزدی برنامه به شما امکان می دهد متن را با تشویق یک عمل خاص در برنامه بنویسید ، مانند ورود به سیستم ، خرید یا رزرو پرواز. آنها به شما امکان می دهند کاربران را به قسمت خاصی از برنامه خود بفرستید تا بتوانند آنچه را که به دنبال آنها آسانتر و سریعتر هستند پیدا کنند.

نمایندگی JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
زمینه های
headlines[]

object ( AdTextAsset )

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

descriptions[]

object ( AdTextAsset )

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

images[]

object ( AdImageAsset )

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

videos[]

object ( AdVideoAsset )

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

ShoppingComparisonListingAdInfo

یک آگهی لیست مقایسه خرید.

نمایندگی JSON
{
  "headline": string
}
زمینه های
headline

string

تیتر تبلیغ. این قسمت مورد نیاز است. طول مجاز بین 25 تا 45 کاراکتر است.

SmartCampaignAdinfo

یک تبلیغ کمپین هوشمند

نمایندگی JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
زمینه های
headlines[]

object ( AdTextAsset )

لیست دارایی های متنی ، که هر یک از آنها در هنگام ارائه تبلیغات مربوط به تیتر است. این لیست از حداقل 3 و حداکثر 15 دارایی متنی تشکیل شده است.

descriptions[]

object ( AdTextAsset )

لیست دارایی های متنی ، که هر یک از آنها هنگام ارائه تبلیغات مربوط به توضیحات است. این لیست از حداقل 2 و حداکثر 4 دارایی متنی تشکیل شده است.

AppRereGistrationAdinfo

برنامه تبلیغات پیش ثبت نام برنامه به برنامه یا لیست بازی شما در Google Play پیوند می دهد و می تواند در Google Play ، در YouTube (فقط در جریان) و در سایر برنامه ها و وب سایت های تلفن همراه در شبکه نمایش اجرا شود. این به جذب علاقه افراد به برنامه یا بازی شما کمک می کند و قبل از راه اندازی یک پایه نصب اولیه برای برنامه یا بازی شما ایجاد می کند.

نمایندگی JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
زمینه های
headlines[]

object ( AdTextAsset )

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

descriptions[]

object ( AdTextAsset )

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

images[]

object ( AdImageAsset )

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

youtubeVideos[]

object ( AdVideoAsset )

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

DiscoverymultiassetAdinfo

یک آگهی چند دارایی Discovery.

نمایندگی JSON
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
زمینه های
marketingImages[]

object ( AdImageAsset )

دارایی های تصویر بازاریابی که در تبلیغ استفاده می شود. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 600x314 و نسبت ابعاد باید 1.91: 1 (+-1 ٪) باشد. در صورت عدم حضور SquaremarketingImages ، لازم است. همراه با squareMarketingImages و portraitMarketingImages حداکثر 20 است.

squareMarketingImages[]

object ( AdImageAsset )

دارایی های تصویر بازاریابی مربع که در آگهی مورد استفاده قرار می گیرند. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 300x300 و نسبت ابعاد باید 1: 1 (+-1 ٪) باشد. در صورت عدم وجود بازاریابی ، مورد نیاز است. همراه با marketingImages و portraitMarketingImages حداکثر 20 است.

portraitMarketingImages[]

object ( AdImageAsset )

دارایی های تصویر بازاریابی پرتره که در تبلیغ استفاده می شود. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 480x600 و نسبت ابعاد باید 4: 5 (+-1 ٪) باشد. همراه با marketingImages و squareMarketingImages حداکثر 20 است.

logoImages[]

object ( AdImageAsset )

دارایی های تصویر آرم که در تبلیغ استفاده می شود. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 128x128 و نسبت ابعاد باید 1: 1 (+-1 ٪) باشد. حداقل 1 و حداکثر تصاویر آرم را می توان مشخص کرد.

headlines[]

object ( AdTextAsset )

دارایی متنی تیتر تبلیغ. حداکثر عرض نمایش 30 است. حداقل 1 و حداکثر 5 عنوان قابل مشخص است.

descriptions[]

object ( AdTextAsset )

متن توصیفی آگهی. حداکثر عرض نمایش 90 است. حداقل 1 و حداکثر 5 توضیحات را می توان مشخص کرد.

businessName

string

تبلیغ کننده/نام تجاری. حداکثر عرض صفحه نمایش 25 است.

callToActionText

string

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

leadFormOnly

boolean

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

DiscoverycarouselAdinfo

یک آگهی کاروسل کشف.

نمایندگی JSON
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}
زمینه های
businessName

string

ضروری. تبلیغ کننده/نام تجاری.

logoImage

object ( AdImageAsset )

ضروری. تصویر آرم برای استفاده در آگهی. حداقل اندازه 128x128 و نسبت ابعاد باید 1: 1 (+-1 ٪) باشد.

headline

object ( AdTextAsset )

ضروری. تیتر تبلیغ.

description

object ( AdTextAsset )

ضروری. متن توصیفی آگهی.

callToActionText

string

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

carouselCards[]

object ( AdDiscoveryCarouselCardAsset )

ضروری. کارتهای چرخ فلک که با تبلیغ نمایش داده می شوند. حداقل 2 حداکثر 10.

addiscoverycarouselcardasset

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

نمایندگی JSON
{
  "asset": string
}
زمینه های
asset

string

نام منابع دارایی این کارت Carousel Discovery Carousel.

DiscoveryVideorEsponsiveAdinfo

یک آگهی پاسخگو ویدیویی کشف.

نمایندگی JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
زمینه های
headlines[]

object ( AdTextAsset )

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

longHeadlines[]

object ( AdTextAsset )

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

descriptions[]

object ( AdTextAsset )

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

videos[]

object ( AdVideoAsset )

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

logoImages[]

object ( AdImageAsset )

تصویر آرم برای استفاده در آگهی. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 128x128 و نسبت ابعاد باید 1: 1 (+-1 ٪) باشد.

breadcrumb1

string

قسمت اول متن که در آگهی با URL نمایش داده شده ظاهر می شود.

breadcrumb2

string

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

businessName

object ( AdTextAsset )

ضروری. تبلیغ کننده/نام تجاری.

callToActions[]

object ( AdCallToActionAsset )

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

adcalltoactionasset

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

نمایندگی JSON
{
  "asset": string
}
زمینه های
asset

string

نام منابع دارایی این فراخوان به Action Asset.

DepalGenproductAdinfo

یک آگهی محصول Gen تقاضا.

نمایندگی JSON
{
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "logoImage": {
    object (AdImageAsset)
  },
  "callToAction": {
    object (AdCallToActionAsset)
  }
}
زمینه های
breadcrumb1

string

قسمت اول متن که در آگهی با URL نمایش داده شده ظاهر می شود.

breadcrumb2

string

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

businessName

object ( AdTextAsset )

ضروری. تبلیغ کننده/نام تجاری.

headline

object ( AdTextAsset )

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

description

object ( AdTextAsset )

ضروری. دارایی متنی مورد استفاده برای توضیحات.

logoImage

object ( AdImageAsset )

ضروری. تصویر آرم برای استفاده در آگهی. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 128x128 و نسبت ابعاد باید 1: 1 (+-1 ٪) باشد.

callToAction

object ( AdCallToActionAsset )

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

TravelAdinfo

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

یک آگهی مسافرتی

مواد و روش ها

get

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

mutate

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