REST Resource: customers.ads

FinalAppUrl

URL สําหรับการทำ Deep Link ในแอปสําหรับระบบปฏิบัติการหนึ่งๆ

การแสดง JSON 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
ช่อง
osType

enum (AppUrlOperatingSystemType)

ระบบปฏิบัติการที่กำหนดเป้าหมายโดย URL นี้ ต้องระบุ
url

string

URL ของ Deep Link ของแอป Deep Link จะระบุตำแหน่งในแอปที่สอดคล้องกับเนื้อหาที่คุณต้องการแสดง และควรอยู่ในรูปแบบ {scheme}://{host_path} รูปแบบจะระบุแอปที่จะเปิด สําหรับแอป คุณจะใช้รูปแบบที่กําหนดเองซึ่งขึ้นต้นด้วยชื่อแอปได้ โฮสต์และเส้นทางจะระบุตำแหน่งที่ไม่ซ้ำกันในแอปที่มีเนื้อหาของคุณอยู่ ตัวอย่างเช่น "exampleapp://productid_1234" ต้องระบุ

AppUrlOperatingSystemType

ระบบปฏิบัติการ

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
IOS ระบบปฏิบัติการ Apple IOS
ANDROID ระบบปฏิบัติการ Android

CustomParameter

การแมปที่แท็กพารามิเตอร์ที่กำหนดเองใช้ได้ใน trackingUrlTemplate, finalUrls หรือ mobile_final_urls

การแสดง JSON 
{
  "key": string,
  "value": string
}
ช่อง
key

string

คีย์ที่ตรงกับชื่อแท็กพารามิเตอร์
value

string

ค่าที่จะใช้แทนที่

AdType

ประเภทโฆษณาที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุค่า
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

นี่เป็นค่าการตอบกลับเท่านั้น
TEXT_AD โฆษณาดังกล่าวเป็นโฆษณาแบบข้อความ
EXPANDED_TEXT_AD โฆษณาดังกล่าวเป็นโฆษณาแบบข้อความที่ขยายออก
EXPANDED_DYNAMIC_SEARCH_AD โฆษณาดังกล่าวเป็นโฆษณา Search แบบไดนามิกอย่างกว้าง
HOTEL_AD โฆษณาดังกล่าวเป็นโฆษณาโรงแรม
SHOPPING_SMART_AD โฆษณาดังกล่าวเป็นโฆษณา Smart Shopping
SHOPPING_PRODUCT_AD โฆษณาดังกล่าวเป็นโฆษณา Shopping มาตรฐาน
VIDEO_AD โฆษณาเป็นโฆษณาวิดีโอ
IMAGE_AD โฆษณานี้เป็นโฆษณาแบบรูปภาพ
RESPONSIVE_SEARCH_AD โฆษณาดังกล่าวเป็นโฆษณา Search ที่ปรับเปลี่ยนตามบริบท
LEGACY_RESPONSIVE_DISPLAY_AD โฆษณาดังกล่าวเป็นโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณาแบบเดิม
APP_AD โฆษณาดังกล่าวเป็นโฆษณาในแอป
LEGACY_APP_INSTALL_AD โฆษณาดังกล่าวเป็นโฆษณาเพื่อการติดตั้งแอปแบบเดิม
RESPONSIVE_DISPLAY_AD โฆษณาดังกล่าวเป็นโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา
LOCAL_AD โฆษณาดังกล่าวเป็นโฆษณาท้องถิ่น
HTML5_UPLOAD_AD โฆษณาเป็นโฆษณา Display ที่อัปโหลดซึ่งมีประเภทผลิตภัณฑ์ HTML5_UPLOAD_AD
DYNAMIC_HTML5_AD โฆษณาเป็นโฆษณา Display ที่อัปโหลดซึ่งมีผลิตภัณฑ์ DYNAMIC_HTML5_* ประเภทใดประเภทหนึ่ง
APP_ENGAGEMENT_AD โฆษณาดังกล่าวเป็นโฆษณาเพื่อการมีส่วนร่วมในแอป
SHOPPING_COMPARISON_LISTING_AD โฆษณาดังกล่าวเป็นโฆษณาเปรียบเทียบสินค้าสำหรับ Shopping
VIDEO_BUMPER_AD โฆษณาวิดีโอบัมเปอร์
VIDEO_NON_SKIPPABLE_IN_STREAM_AD โฆษณาในสตรีมแบบข้ามไม่ได้แบบวิดีโอ
VIDEO_OUTSTREAM_AD โฆษณาวิดีโอนอกสตรีม
VIDEO_TRUEVIEW_IN_STREAM_AD โฆษณาวิดีโอ TrueView ในสตรีม
VIDEO_RESPONSIVE_AD โฆษณาวิดีโอที่ปรับเปลี่ยนตามพื้นที่โฆษณา
SMART_CAMPAIGN_AD โฆษณา Smart Campaign
CALL_AD โฆษณาแบบโทรออก
APP_PRE_REGISTRATION_AD โฆษณาการลงทะเบียนล่วงหน้าใน Universal App
IN_FEED_VIDEO_AD โฆษณาวิดีโอในฟีด
DISCOVERY_MULTI_ASSET_AD โฆษณา Discovery แบบคอนเทนต์หลายรายการ
TRAVEL_AD โฆษณาการท่องเที่ยว
DISCOVERY_VIDEO_RESPONSIVE_AD โฆษณาวิดีโอ Discovery ที่ปรับเปลี่ยนตามพื้นที่โฆษณา

อุปกรณ์

แจกแจงอุปกรณ์ Google Ads ที่ใช้ได้สำหรับการกำหนดเป้าหมาย

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ไม่รู้จักค่าในเวอร์ชันนี้
MOBILE โทรศัพท์มือถือที่มีเบราว์เซอร์เต็มรูปแบบ
TABLET แท็บเล็ตที่มีเบราว์เซอร์เต็มรูปแบบ
DESKTOP คอมพิวเตอร์
CONNECTED_TV สมาร์ททีวีและคอนโซลเกม
OTHER อุปกรณ์ประเภทอื่น

UrlCollection

คอลเล็กชันของ URL ที่ติดแท็กด้วยตัวระบุที่ไม่ซ้ำกัน

การแสดง JSON 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
ช่อง
finalUrls[]

string

รายการ URL สุดท้ายที่เป็นไปได้
finalMobileUrls[]

string

รายการ URL สุดท้ายบนอุปกรณ์เคลื่อนที่ที่เป็นไปได้
urlCollectionId

string

ตัวระบุที่ไม่ซ้ำกันสำหรับอินสแตนซ์ UrlCollection นี้
trackingUrlTemplate

string

เทมเพลต URL สำหรับการสร้าง URL ติดตาม

SystemManagedResourceSource

แจกแจงรายการแหล่งที่มาของเอนทิตีที่ระบบจัดการที่เป็นไปได้

Enum
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

ส่วนที่ 3 ของบรรทัดแรกของโฆษณา
description

string

คำอธิบายของโฆษณา
description2

string

คำอธิบายที่ 2 ของโฆษณา
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

บรรทัดแรกที่ 2 ในโฆษณา
description1

string

บรรทัดแรกของคำอธิบายโฆษณา
description2

string

บรรทัดที่สองของคำอธิบายโฆษณา
callTracked

boolean

จะเปิดใช้การติดตามการโทรสำหรับครีเอทีฟโฆษณาหรือไม่ การเปิดใช้การติดตามการโทรจะเป็นการเปิดใช้ Conversion การโทรด้วย
disableCallConversion

boolean

จะปิดใช้ Conversion การโทรสำหรับครีเอทีฟโฆษณาไหม หากตั้งค่าเป็น true จะปิดใช้ Conversion การโทรแม้ว่า callTracked จะเป็น true ก็ตาม หาก callTracked คือ false ระบบจะไม่สนใจช่องนี้
phoneNumberVerificationUrl

string

URL ที่จะใช้สำหรับการยืนยันหมายเลขโทรศัพท์
conversionAction

string

การกระทำที่ถือเป็น Conversion ที่จะระบุแหล่งที่มาของ Conversion การโทร หากไม่ได้กำหนด ระบบจะใช้การกระทำที่ถือเป็น Conversion เริ่มต้น ช่องนี้จะมีผลก็ต่อเมื่อตั้งค่า callTracked เป็น true เท่านั้น มิฉะนั้นระบบจะไม่สนใจช่องนี้
conversionReportingState

enum (CallConversionReportingState)

พฤติกรรม Conversion การโทรของโฆษณาแบบโทรออกนี้ ใช้การตั้งค่า Conversion การโทรของตัวเอง รับช่วงการตั้งค่าระดับบัญชี หรือปิดใช้ก็ได้
path1

string

ส่วนแรกของข้อความที่สามารถต่อท้าย URL ในโฆษณาได้ ไม่บังคับ
path2

string

ส่วนที่สองของข้อความที่สามารถต่อท้าย URL ในโฆษณาได้ ช่องนี้จะตั้งค่าได้ก็ต่อเมื่อตั้งค่า path1 ด้วยเท่านั้น ไม่บังคับ

CallConversionReportingState

ประเภทข้อมูลที่เป็นไปได้สําหรับสถานะการกระทําที่ถือเป็น Conversion การโทร

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
DISABLED ปิดใช้การกระทำที่ถือเป็น Conversion การโทร
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION การกระทำที่ถือเป็น Conversion การโทรจะใช้ประเภท Conversion การโทรที่ตั้งค่าไว้ที่ระดับบัญชี
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION การกระทำที่ถือเป็น Conversion การโทรจะใช้ประเภท Conversion การโทรที่ตั้งค่าไว้ที่ระดับทรัพยากร (โฆษณาแบบโทรออกเท่านั้น/ส่วนขยายการโทร)

ExpandedDynamicSearchAdInfo

โฆษณา Search แบบไดนามิกอย่างกว้าง

การแสดง JSON 
{
  "description": string,
  "description2": string
}
ช่อง
description

string

คำอธิบายของโฆษณา
description2

string

คำอธิบายที่ 2 ของโฆษณา

HotelAdInfo

ประเภทนี้ไม่มีช่อง

โฆษณาโรงแรม

ShoppingSmartAdInfo

ประเภทนี้ไม่มีช่อง

โฆษณา Smart Shopping

ShoppingProductAdInfo

ประเภทนี้ไม่มีช่อง

โฆษณา Shopping มาตรฐาน

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:
  "mediaFile": string,
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
ช่อง
mimeType

enum (MimeType)

ประเภท MIME ของรูปภาพ
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 รูปภาพที่จะใช้สร้างโฆษณาแบบรูปภาพ โดยระบุได้ 2 วิธี 1. ทรัพยากร MediaFile ที่มีอยู่ 2. ข้อมูลรูปภาพดิบเป็นไบต์ image ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
mediaFile

string

ทรัพยากร MediaFile ที่ใช้สำหรับรูปภาพ
data

string (bytes format)

ข้อมูลรูปภาพดิบเป็นไบต์

สตริงที่เข้ารหัสฐาน 64
adIdToCopyImageFrom

string (int64 format)

รหัสโฆษณาที่จะคัดลอกรูปภาพ

MimeType

ประเภท MIME

Enum
UNSPECIFIED ไม่ได้ระบุประเภท MIME
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

นี่เป็นค่าการตอบกลับเท่านั้น
IMAGE_JPEG ประเภท MIME ของรูปภาพ/jpeg
IMAGE_GIF ประเภท MIME ของรูปภาพ/gif
IMAGE_PNG ประเภท MIME ของรูปภาพ/png
FLASH ประเภท MIME ของแอปพลิเคชัน/x-shockWave-flash
TEXT_HTML ประเภท MIME ของข้อความ/html
PDF ประเภท MIME ของแอปพลิเคชัน/pdf
MSWORD ประเภท MIME ของแอปพลิเคชัน/msword
MSEXCEL ประเภท MIME ของ application/vnd.ms-excel
RTF ประเภท MIME ของแอปพลิเคชัน/RTF
AUDIO_WAV ประเภท MIME ของเสียง/WAV
AUDIO_MP3 ประเภท MIME ของเสียง/MP3
HTML5_AD_ZIP ประเภท MIME ของแอปพลิเคชัน/x-html5-ad-zip

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 ในสตรีมของวิดีโอ (โฆษณาที่แสดงระหว่างการเล่นวิดีโอ ซึ่งมักแสดงที่ช่วงต้นของวิดีโอ ซึ่งแสดงปุ่มข้ามในวิดีโอ 2-3 วินาที)

การแสดง JSON 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
ช่อง
actionButtonLabel

string

ป้ายกำกับบนปุ่ม CTA (คำกระตุ้นให้ดำเนินการ) ที่นำผู้ใช้ไปยัง URL สุดท้ายของโฆษณาวิดีโอ ต้องระบุสำหรับแคมเปญ TrueView for Action (ไม่บังคับ)
actionHeadline

string

ข้อความเพิ่มเติมที่แสดงพร้อมปุ่ม CTA (คำกระตุ้นให้ดำเนินการ) เพื่อให้บริบทและกระตุ้นให้คลิกปุ่ม
companionBanner

object (AdImageAsset)

ชิ้นงานรูปภาพของแบนเนอร์ที่แสดงร่วมกันซึ่งใช้กับโฆษณา

AdImageAsset

ชิ้นงานรูปภาพที่ใช้ภายในโฆษณา

การแสดง JSON 
{
  "asset": string
}
ช่อง
asset

string

ชื่อทรัพยากรเนื้อหาของรูปภาพนี้

VideoBumperInStreamAdInfo

การนำเสนอรูปแบบโฆษณาวิดีโอในสตรีมบัมเปอร์ (ซึ่งเป็นโฆษณาวิดีโอแบบข้ามไม่ได้ในสตรีมที่สั้นมาก)

การแสดง JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
ช่อง
companionBanner

object (AdImageAsset)

ชิ้นงานรูปภาพของแบนเนอร์ที่แสดงร่วมกันซึ่งใช้กับโฆษณา
actionButtonLabel

string

ป้ายกำกับบนปุ่ม "คำกระตุ้นให้ดำเนินการ" ที่นำผู้ใช้ไปยัง URL สุดท้ายของโฆษณาวิดีโอ
actionHeadline

string

ข้อความเพิ่มเติมที่แสดงพร้อมปุ่ม CTA (คำกระตุ้นให้ดำเนินการ) เพื่อให้บริบทและกระตุ้นให้คลิกปุ่ม

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

ป้ายกำกับบนปุ่ม "คำกระตุ้นให้ดำเนินการ" ที่นำผู้ใช้ไปยัง URL สุดท้ายของโฆษณาวิดีโอ
actionHeadline

string

ข้อความเพิ่มเติมที่แสดงพร้อมปุ่ม "คำกระตุ้นให้ดำเนินการ" เพื่อให้บริบทและกระตุ้นให้คลิกปุ่ม

InFeedVideoAdInfo

การนำเสนอรูปแบบโฆษณาวิดีโอในฟีด

การแสดง JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
ช่อง
headline

string

บรรทัดแรกของโฆษณา
description1

string

ข้อความบรรทัดแรกสำหรับโฆษณา
description2

string

บรรทัดข้อความที่สองสำหรับโฆษณา
thumbnail

enum (VideoThumbnail)

รูปภาพขนาดย่อของวิดีโอที่จะใช้

VideoThumbnail

แจกแจงประเภทภาพขนาดย่อของวิดีโอที่เป็นไปได้

Enum
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)

รายการเนื้อหาข้อความที่ใช้สำหรับปุ่ม เช่น ปุ่ม "คำกระตุ้นให้ดำเนินการ" ปัจจุบันระบบรองรับปุ่มเพียงค่าเดียว
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

ประเภทฟิลด์เนื้อหาที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุค่า
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

นี่เป็นค่าการตอบกลับเท่านั้น
HEADLINE_1 มีการใช้ชิ้นงานนี้ในบรรทัดแรก 1
HEADLINE_2 มีการใช้ชิ้นงานนี้ในบรรทัดแรก 2
HEADLINE_3 มีการใช้ชิ้นงานนี้ในบรรทัดแรก 3
DESCRIPTION_1 มีการใช้ชิ้นงานนี้ในคำอธิบาย 1
DESCRIPTION_2 มีการใช้ชิ้นงานนี้ในคำอธิบาย 2
CALL ระบบใช้ชิ้นงานนี้เป็นการโทร
MOBILE_APP มีการใช้เนื้อหานี้เป็นแอปบนอุปกรณ์เคลื่อนที่
CALLOUT ระบบใช้ชิ้นงานนี้เป็นไฮไลต์
STRUCTURED_SNIPPET ระบบใช้ชิ้นงานนี้เป็นข้อมูลเพิ่มเติม
PRICE ระบบใช้ชิ้นงานนี้เป็นราคา
PROMOTION ชิ้นงานนี้ใช้เป็นโปรโมชัน
AD_IMAGE ระบบใช้ชิ้นงานนี้เป็นรูปภาพ
LEAD_FORM มีการใช้ชิ้นงานเป็นโฆษณาแบบกรอกฟอร์ม

AssetPerformanceLabel

ennum ที่อธิบายป้ายกำกับประสิทธิภาพที่เป็นไปได้ของเนื้อหา ซึ่งมักจะคำนวณในบริบทของการลิงก์

Enum
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 แต่ละรายการมีหัวข้อที่ระบุนโยบายโฆษณาที่เกี่ยวข้องกับรายการนั้นๆ และประเภทเพื่อบ่งชี้ผลกระทบที่รายการจะมีต่อการแสดง ซึ่งอาจมีหลักฐานอย่างน้อย 1 รายการที่ระบุเหตุผลของผลการสืบค้น และอาจมีข้อจำกัดอย่างน้อย 1 ข้อที่ระบุรายละเอียดเกี่ยวกับวิธีจำกัดการแสดงโฆษณาด้วย

การแสดง 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

ประเภทรายการหัวข้อนโยบายที่เป็นไปได้

Enum
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 หรือไม่ทำงานในทุกตำแหน่งสำหรับอุปกรณ์ที่ใช้ทั่วไป

WebsiteList

รายการเว็บไซต์ที่ทําให้เกิดการค้นหานโยบาย ใช้สำหรับหัวข้อนโยบาย ONE_WEBSITE_PER_AD_GROUP เป็นต้น ในกรณีที่มีมากกว่า 5 เว็บไซต์ ระบบจะแสดงเฉพาะเว็บไซต์ 5 อันดับแรก (เว็บไซต์ที่ปรากฏในแหล่งข้อมูลมากที่สุด)

การแสดง JSON 
{
  "websites": [
    string
  ]
}
ช่อง
websites[]

string

เว็บไซต์ที่ทำให้เกิดการค้นพบนโยบาย

TextList

รายการส่วนย่อยของข้อความที่ละเมิดนโยบาย

การแสดง JSON 
{
  "texts": [
    string
  ]
}
ช่อง
texts[]

string

ส่วนย่อยของข้อความจากทรัพยากรที่ทำให้เกิดการค้นหานโยบาย

DestinationTextList

รายการสตริงที่พบในหน้าปลายทางที่ทำให้เกิดการค้นหานโยบาย

การแสดง JSON 
{
  "destinationTexts": [
    string
  ]
}
ช่อง
destinationTexts[]

string

รายการข้อความที่พบในหน้าปลายทางของทรัพยากร

DestinationMismatch

หลักฐานการไม่ตรงกันระหว่าง URL ของทรัพยากร

การแสดง JSON 
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
ช่อง
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

ชุด URL ที่ไม่ตรงกัน

PolicyTopicEvidenceDestinationMismatchUrlType

ปลายทางหลักฐานหัวข้อนโยบายที่เป็นไปได้ไม่ตรงกับประเภท URL

Enum
UNSPECIFIED ไม่ได้ระบุค่า
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

นี่เป็นค่าการตอบกลับเท่านั้น
DISPLAY_URL URL ที่แสดง
FINAL_URL URL สุดท้าย
FINAL_MOBILE_URL URL สุดท้ายบนอุปกรณ์เคลื่อนที่
TRACKING_URL เทมเพลต URL ติดตามผลที่มี URL เดสก์ท็อปแทนที่
MOBILE_TRACKING_URL เทมเพลต URL ติดตามผลที่มี 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

หลักฐานหัวข้อนโยบายที่เป็นไปได้ของอุปกรณ์ปลายทางใช้งานไม่ได้

Enum
UNSPECIFIED ไม่ได้ระบุค่า
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

นี่เป็นค่าการตอบกลับเท่านั้น
DESKTOP หน้า Landing Page ไม่ทำงานบนอุปกรณ์เดสก์ท็อป
ANDROID หน้า Landing Page ไม่ทำงานบนอุปกรณ์ Android
IOS หน้า Landing Page ไม่ทำงานบนอุปกรณ์ iOS

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

ปลายทางหลักฐานหัวข้อนโยบายที่เป็นไปได้ประเภทข้อผิดพลาด DNS ใช้งานไม่ได้

Enum
UNSPECIFIED ไม่ได้ระบุค่า
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

นี่เป็นค่าการตอบกลับเท่านั้น
HOSTNAME_NOT_FOUND ไม่พบชื่อโฮสต์ใน DNS เมื่อดึงข้อมูลหน้า Landing Page
GOOGLE_CRAWLER_DNS_ISSUE ปัญหา Crawler ภายในของ Google เมื่อสื่อสารกับ DNS ข้อผิดพลาดนี้ไม่ได้หมายความว่าหน้า Landing Page ไม่ทำงาน Google จะทำการ Crawl หน้า Landing Page อีกครั้ง

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

จำนวนประเทศทั้งหมดที่แหล่งข้อมูลกำหนดเป้าหมาย

CountryConstraint

ระบุว่าความสามารถในการให้บริการของทรัพยากรในประเทศหนึ่งๆ ถูกจำกัด

การแสดง JSON 
{
  "countryCriterion": string
}
ช่อง
countryCriterion

string

ชื่อทรัพยากรคงที่ที่กำหนดเป้าหมายตามภูมิศาสตร์ของประเทศที่มีข้อจำกัดการให้บริการ

ResellerConstraint

ประเภทนี้ไม่มีช่อง

ระบุว่าหัวข้อนโยบายถูกจำกัดเนื่องจากการไม่อนุมัติเว็บไซต์สำหรับวัตถุประสงค์ของตัวแทนจำหน่าย

PolicyReviewStatus

สถานะการตรวจสอบนโยบายที่เป็นไปได้

Enum
UNSPECIFIED ไม่ได้ระบุค่า
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

นี่เป็นค่าการตอบกลับเท่านั้น
REVIEW_IN_PROGRESS อยู่ระหว่างตรวจสอบ
REVIEWED การตรวจสอบหลักเสร็จสมบูรณ์แล้ว รีวิวอื่นๆ อาจดําเนินต่อไป
UNDER_APPEAL มีการส่งทรัพยากรเข้ารับการอนุมัติอีกครั้ง หรือได้มีการอุทธรณ์คำตัดสินเรื่องนโยบายแล้ว
ELIGIBLE_MAY_SERVE ทรัพยากรมีสิทธิ์และอาจแสดงผลอยู่ แต่ยังอยู่ระหว่างการตรวจสอบเพิ่มเติม

PolicyApprovalStatus

สถานะการอนุมัติตามนโยบายที่เป็นไปได้ เมื่อมีสถานะการอนุมัติหลายรายการ ระบบจะใช้ระดับที่ร้ายแรงที่สุด ลำดับความรุนแรงคือ DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED และ APPROVED

Enum
UNSPECIFIED ไม่ได้ระบุค่า
UNKNOWN

ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้

นี่เป็นค่าการตอบกลับเท่านั้น
DISAPPROVED จะไม่แสดง
APPROVED_LIMITED แสดงแบบจำกัด
APPROVED ให้บริการโดยไม่มีข้อจำกัด
AREA_OF_INTEREST_ONLY จะไม่แสดงในประเทศเป้าหมาย แต่อาจแสดงต่อผู้ใช้ที่กำลังค้นหาข้อมูลเกี่ยวกับประเทศเป้าหมาย

ResponsiveSearchAdInfo

โฆษณา Search ที่ปรับเปลี่ยนตามบริบท

โฆษณา Search ที่ปรับเปลี่ยนตามบริบทช่วยให้คุณสร้างโฆษณาที่ปรับเปลี่ยนเพื่อแสดงข้อความให้มากขึ้นและส่งสารที่ตรงตามความต้องการของลูกค้ามากขึ้นด้วย กรอกบรรทัดแรกและคำอธิบายหลายรายการเมื่อสร้างโฆษณา Search ที่ปรับเปลี่ยนตามบริบท แล้วเมื่อเวลาผ่านไป Google Ads จะทดสอบบรรทัดแรกและคำอธิบายต่างๆ ผสมกันโดยอัตโนมัติเพื่อดูว่าส่วนผสมแบบใดทำงานเข้ากันได้ดีที่สุด โฆษณา Search ที่ปรับเปลี่ยนตามบริบทช่วยปรับปรุงประสิทธิภาพแคมเปญได้ด้วยการปรับเปลี่ยนเนื้อหาของโฆษณาให้ใกล้เคียงกับข้อความค้นหาของผู้มีโอกาสเป็นลูกค้ามากขึ้น

ดูข้อมูลเพิ่มเติมได้ที่ 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

โฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณาแบบเดิม โฆษณาประเภทนี้จะมีป้ายกำกับเป็น "โฆษณาที่ปรับเปลี่ยนตามอุปกรณ์" ใน UI ของ 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

สีเฉพาะจุดของโฆษณาในรูปแบบเลขฐาน 16 เช่น #ffffff สำหรับสีขาว หากตั้งค่ารายการใดรายการหนึ่งเป็น mainColor และ accentColor จะต้องมีการตั้งค่าอีกรายการด้วย
mainColor

string

สีหลักของโฆษณาในรูปแบบเลขฐาน 16 เช่น #ffffff สำหรับสีขาว หากตั้งค่ารายการใดรายการหนึ่งเป็น mainColor และ accentColor จะต้องมีการตั้งค่าอีกรายการด้วย
callToActionText

string

ข้อความกระตุ้นการตัดสินใจสำหรับโฆษณา
logoImage

string

ชื่อทรัพยากร MediaFile ของรูปภาพโลโก้ที่ใช้ในโฆษณา
squareLogoImage

string

ชื่อทรัพยากร MediaFile ของรูปภาพโลโก้สี่เหลี่ยมจัตุรัสที่ใช้ในโฆษณา
marketingImage

string

ชื่อทรัพยากร MediaFile ของรูปภาพการตลาดที่ใช้ในโฆษณา
squareMarketingImage

string

ชื่อทรัพยากร MediaFile ของรูปภาพการตลาดแบบสี่เหลี่ยมจัตุรัสที่ใช้ในโฆษณา
pricePrefix

string

ใส่คำนำหน้าก่อนราคา เช่น "ต่ำสุดถึง"
promoText

string

ข้อความโปรโมชันที่ใช้สำหรับรูปแบบแบบไดนามิกของโฆษณาที่ปรับเปลี่ยนตามพื้นที่โฆษณา เช่น "จัดส่งฟรีใน 2 วัน"

DisplayAdFormatSetting

แจกแจงการตั้งค่ารูปแบบโฆษณาแบบดิสเพลย์

Enum
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)

App Store ที่มีแอปบนอุปกรณ์เคลื่อนที่
appId

string

รหัสของแอปบนอุปกรณ์เคลื่อนที่
headline

string

บรรทัดแรกของโฆษณา
description1

string

บรรทัดรายละเอียดแรกของโฆษณา
description2

string

บรรทัดรายละเอียดที่ 2 ของโฆษณา

LegacyAppInstallAdAppStore

ประเภท App Store ในโฆษณาเพื่อการติดตั้งแอปเดิม

Enum
UNSPECIFIED ไม่ได้ระบุ
UNKNOWN ใช้สำหรับค่าที่ส่งกลับเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้
APPLE_APP_STORE Apple iTunes
GOOGLE_PLAY Google Play
WINDOWS_STORE Windows Store
WINDOWS_PHONE_STORE Windows Phone Store
CN_APP_STORE แอปโฮสต์อยู่ใน App Store ของจีน

ResponsiveDisplayAdInfo

โฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา

การแสดง 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 อย่างน้อย 1 รายการ เมื่อรวมกับ squareMarketingImages แล้วจำนวนสูงสุดคือ 15 รายการ
squareMarketingImages[]

object (AdImageAsset)

รูปภาพการตลาดสี่เหลี่ยมจัตุรัสที่จะใช้ในโฆษณา ประเภทรูปภาพที่ใช้ได้ ได้แก่ GIF, JPEG และ PNG ขนาดขั้นต่ำคือ 300x300 และสัดส่วนภาพต้องเป็น 1:1 (+-1%) ต้องมีmarketingImageสี่เหลี่ยมจัตุรัสอย่างน้อย 1 รูป เมื่อรวมกับ 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

สีหลักของโฆษณาในรูปแบบเลขฐาน 16 เช่น #ffffff สำหรับสีขาว หากตั้งค่ารายการใดรายการหนึ่งเป็น mainColor และ accentColor จะต้องมีการตั้งค่าอีกรายการด้วย
accentColor

string

สีเฉพาะจุดของโฆษณาในรูปแบบเลขฐาน 16 เช่น #ffffff สำหรับสีขาว หากตั้งค่ารายการใดรายการหนึ่งเป็น mainColor และ accentColor จะต้องมีการตั้งค่าอีกรายการด้วย
allowFlexibleColor

boolean

ความยินยอมของผู้ลงโฆษณาให้ใช้สีที่ปรับเปลี่ยนได้ เมื่อเป็นจริง โฆษณาอาจแสดงด้วยสีอื่นหากจำเป็น หากเป็นเท็จ โฆษณาจะแสดงด้วยสีที่ระบุหรือสีปานกลาง ค่าเริ่มต้นคือ true ต้องเป็น "จริง" หากไม่ได้ตั้งค่า mainColor และ accentColor
callToActionText

string

ข้อความกระตุ้นการตัดสินใจสำหรับโฆษณา ความกว้างการแสดงผลสูงสุดคือ 30
pricePrefix

string

ใส่คำนำหน้าก่อนราคา เช่น "ต่ำสุดถึง"
promoText

string

ข้อความโปรโมชันที่ใช้สำหรับรูปแบบแบบไดนามิกของโฆษณาที่ปรับเปลี่ยนตามพื้นที่โฆษณา เช่น "จัดส่งฟรีใน 2 วัน"

ResponsiveDisplayAdControlSpec

ข้อกำหนดสำหรับการควบคุมครีเอทีฟโฆษณาต่างๆ สำหรับโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา

การแสดง 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)

รายการชิ้นงานข้อความสำหรับคำกระตุ้นให้ดำเนินการ เมื่อโฆษณาแสดง คำกระตุ้นให้ดำเนินการจะถูกเลือกจากรายการนี้ ต้องระบุคำกระตุ้นให้ดำเนินการ (Call-To-Action) อย่างน้อย 1 รายการ
marketingImages[]

object (AdImageAsset)

รายการชิ้นงานรูปภาพการตลาดที่อาจแสดงพร้อมกับโฆษณา รูปภาพต้องมีขนาด 314x600 พิกเซล หรือ 320x320 พิกเซล ต้องระบุชิ้นงานรูปภาพอย่างน้อย 1 รายการและไม่เกิน 20 รายการ
logoImages[]

object (AdImageAsset)

รายการชิ้นงานรูปภาพโลโก้ที่อาจแสดงพร้อมกับโฆษณา รูปภาพต้องมีขนาด 128x128 พิกเซลและมีขนาดไม่เกิน 120 KB ต้องระบุชิ้นงานรูปภาพอย่างน้อย 1 รายการและไม่เกิน 5 รายการ
videos[]

object (AdVideoAsset)

รายการเนื้อหาวิดีโอ YouTube ที่อาจแสดงพร้อมกับโฆษณา ต้องระบุชิ้นงานวิดีโออย่างน้อย 1 รายการและไม่เกิน 20 รายการ
path1

string

ส่วนแรกของข้อความที่ไม่บังคับซึ่งสามารถนำไปต่อท้าย URL ในโฆษณาได้
path2

string

ส่วนที่ 2 ของข้อความที่ไม่บังคับซึ่งสามารถนำไปต่อท้าย URL ในโฆษณาได้ ช่องนี้จะตั้งค่าได้ก็ต่อเมื่อตั้งค่า path1 ด้วยเท่านั้น

DisplayUploadAdInfo

ประเภทโฆษณาแบบดิสเพลย์ทั่วไป ช่อง displayUploadProductType จะควบคุมรูปแบบโฆษณาที่แน่นอน ซึ่งจะกำหนดประเภทข้อมูลที่ต้องรวมไว้ในโฆษณา

การแสดง 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
ฟิลด์สหภาพ media_asset ข้อมูลชิ้นงานที่ประกอบกันเป็นโฆษณา media_asset ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
mediaBundle

object (AdMediaBundleAsset)

ชิ้นงานไฟล์ครีเอทีฟโฆษณาที่จะใช้ในโฆษณา ดูข้อมูลเกี่ยวกับไฟล์ครีเอทีฟโฆษณา HTML5_UPLOAD_AD ได้ที่ https://support.google.com/google-ads/answer/1722096 ไฟล์ครีเอทีฟโฆษณาที่เป็นส่วนหนึ่งของประเภทผลิตภัณฑ์แบบไดนามิกจะใช้รูปแบบพิเศษที่ต้องสร้างผ่าน Google Web Designer ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/webdesigner/answer/7543898

DisplayUploadProductType

แจกแจงประเภทผลิตภัณฑ์ที่อัปโหลดแบบแสดง

Enum
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

โฆษณาเปรียบเทียบสินค้าใน Shopping

การแสดง JSON 
{
  "headline": string
}
ช่อง
headline

string

บรรทัดแรกของโฆษณา ต้องระบุฟิลด์นี้ ความยาวที่อนุญาตอยู่ระหว่าง 25 ถึง 45 อักขระ

SmartCampaignAdInfo

โฆษณา Smart Campaign

การแสดง JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
ช่อง
headlines[]

object (AdTextAsset)

รายการชิ้นงานข้อความ แต่ละรายการจะตรงกับบรรทัดแรกเมื่อโฆษณาแสดง รายการนี้ประกอบด้วยชิ้นงานข้อความอย่างน้อย 3 รายการและสูงสุด 15 รายการ
descriptions[]

object (AdTextAsset)

รายการชิ้นงานข้อความ ซึ่งแต่ละรายการจะสอดคล้องกับคำอธิบายเมื่อโฆษณาแสดง รายการนี้ประกอบด้วยชิ้นงานข้อความอย่างน้อย 2 รายการและสูงสุด 4 รายการ

AppPreRegistrationAdInfo

โฆษณาการลงทะเบียนล่วงหน้าของแอปจะลิงก์ไปยังข้อมูลแอปหรือเกมของคุณใน Google Play และแสดงใน Google Play, YouTube (ในสตรีมเท่านั้น) รวมถึงภายในแอปและเว็บไซต์ในอุปกรณ์เคลื่อนที่อื่นๆ ในเครือข่าย Display ได้ ช่วยดึงดูดความสนใจของผู้คนในแอปหรือเกม และสร้างฐานผู้ใช้งานที่ติดตั้งแอปหรือเกมของคุณล่วงหน้าก่อนการเปิดตัว

การแสดง 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 ภาพและสูงสุด 5 ภาพ
headlines[]

object (AdTextAsset)

ชิ้นงานข้อความบรรทัดแรกของโฆษณา ความกว้างการแสดงผลสูงสุดคือ 30 ระบุบรรทัดแรกได้อย่างน้อย 1 รายการและสูงสุด 5 รายการ
descriptions[]

object (AdTextAsset)

ข้อความอธิบายของโฆษณา ความกว้างการแสดงผลสูงสุดคือ 90 ระบุคำอธิบายได้อย่างน้อย 1 รายการและสูงสุด 5 รายการ
businessName

string

ชื่อผู้ลงโฆษณา/แบรนด์ ความกว้างการแสดงผลสูงสุดคือ 25 ต้องระบุ
callToActionText

string

ข้อความกระตุ้นการตัดสินใจ
leadFormOnly

boolean

ตัวเลือกบูลีนที่ระบุว่าโฆษณานี้ต้องแสดงพร้อมโฆษณาแบบกรอกฟอร์มหรือไม่

DiscoveryCarouselAdInfo

โฆษณา Discovery แบบภาพสไลด์

การแสดง 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

เนื้อหาของการ์ด Discovery แบบภาพสไลด์ที่ใช้ภายในโฆษณา

การแสดง JSON 
{
  "asset": string
}
ช่อง
asset

string

ชื่อทรัพยากรเนื้อหาของการ์ด Discovery แบบภาพสไลด์นี้

DiscoveryVideoResponsiveAdInfo

โฆษณาวิดีโอ Discovery ที่ปรับเปลี่ยนตามพื้นที่โฆษณา

การแสดง 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

ชื่อทรัพยากรเนื้อหาของชิ้นงานคำกระตุ้นให้ดำเนินการนี้

TravelAdInfo

ประเภทนี้ไม่มีช่อง

โฆษณาการท่องเที่ยว

วิธีการ

get

 แสดงโฆษณาที่ขออย่างละเอียด

mutate

 อัปเดตโฆษณา