Method: customers.suggestTravelAssets

แสดงคำแนะนำชิ้นงานการท่องเที่ยว คำแนะนำเนื้อหาจะทำงานอย่างเต็มความสามารถ เราไม่รับประกันว่าจะส่งคืนชิ้นงานทุกประเภทที่เป็นไปได้สำหรับที่พักที่ระบุ

คำขอ HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:suggestTravelAssets

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

ต้องระบุ รหัสของลูกค้า

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้

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

string

ต้องระบุ ข้อกําหนดด้านภาษาในรูปแบบ BCP 47 (เช่น en-US, zh-CN ฯลฯ) สําหรับคําแนะนําเนื้อหา ข้อความจะเป็นภาษานี้ มักจะตรงกับภาษาเป้าหมายของแคมเปญภาษาใดภาษาหนึ่ง
placeIds[]

string

รหัสสถานที่ใน Google Maps ของโรงแรมที่ขอชิ้นงาน ดูข้อมูลเพิ่มเติมได้ที่ https://developers.google.com/places/web-service/place-id

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ TravelAssetSuggestionService.SuggestTravelAssets

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
ช่อง
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

คำแนะนำเนื้อหาสำหรับรหัสสถานที่แต่ละรายการที่ส่งในคำขอ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/adwords

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0

HotelAssetSuggestion

ข้อความที่มีคำแนะนำชิ้นงานสำหรับโรงแรม

การแสดง JSON 
{
  "placeId": string,
  "finalUrl": string,
  "hotelName": string,
  "callToAction": enum (CallToActionType),
  "textAssets": [
    {
      object (HotelTextAsset)
    }
  ],
  "imageAssets": [
    {
      object (HotelImageAsset)
    }
  ],
  "status": enum (HotelAssetSuggestionStatus)
}
ช่อง
placeId

string

รหัส Google Places ของโรงแรม
finalUrl

string

URL สุดท้ายที่แนะนำสำหรับ AssetGroup
hotelName

string

ชื่อโรงแรมในภาษาที่ต้องการ
callToAction

enum (CallToActionType)

ประเภทคำกระตุ้นให้ดำเนินการ
textAssets[]

object (HotelTextAsset)

ชิ้นงานข้อความ เช่น บรรทัดแรก คําอธิบาย ฯลฯ
imageAssets[]

object (HotelImageAsset)

ชิ้นงานรูปภาพ เช่น แนวนอน/แนวตั้ง/สี่เหลี่ยมจัตุรัส ฯลฯ
status

enum (HotelAssetSuggestionStatus)

สถานะของคําแนะนําชิ้นงานโรงแรม

HotelTextAsset

คำแนะนำชิ้นงานข้อความ 1 รายการสำหรับโรงแรม

การแสดง JSON 
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
ช่อง
text

string

ข้อความเนื้อหาในภาษาที่ขอ
assetFieldType

enum (AssetFieldType)

ประเภทชิ้นงานข้อความ เช่น HEADLINE, DESCRIPTION เป็นต้น

HotelImageAsset

คําแนะนําชิ้นงานรูปภาพ 1 รายการสําหรับโรงแรม

การแสดง JSON 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
ช่อง
uri

string

URI ของรูปภาพ
assetFieldType

enum (AssetFieldType)

ประเภทชิ้นงานรูปภาพ ตัวอย่างเช่น MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE ฯลฯ

HotelAssetSuggestionStatus

สถานะที่เป็นไปได้ของคําแนะนําชิ้นงานโรงแรม

Enum
UNSPECIFIED ไม่ได้ระบุ enum
UNKNOWN ไม่รู้จักรหัสข้อผิดพลาดที่ได้รับในเวอร์ชันนี้
SUCCESS เรียกข้อมูลคำแนะนำชิ้นงานโรงแรมเรียบร้อยแล้ว
HOTEL_NOT_FOUND การค้นหาโรงแรมไม่พบผลลัพธ์ใดๆ
INVALID_PLACE_ID รหัส Google Places ไม่ถูกต้องและถอดรหัสไม่ได้