Method: customers.suggestTravelAssets

Menampilkan saran Aset Perjalanan. Saran aset ditampilkan berdasarkan upaya terbaik. Tidak ada jaminan bahwa semua jenis aset yang memungkinkan akan ditampilkan untuk properti hotel tertentu.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
Kolom
languageOption

string

Wajib. Spesifikasi bahasa dalam format BCP 47 (misalnya, en-US, zh-CN, dll.) untuk saran aset. Teks akan menggunakan bahasa ini. Biasanya cocok dengan salah satu bahasa target kampanye.
placeIds[]

string

ID Tempat Google Maps hotel yang asetnya diminta. Lihat https://developers.google.com/places/web-service/place-id untuk informasi selengkapnya.

Isi respons

Pesan respons untuk TravelAssetSuggestionService.SuggestTravelAssets.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
Kolom
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

Saran aset untuk setiap ID tempat yang dikirimkan dalam permintaan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

HotelAssetSuggestion

Pesan yang berisi saran aset untuk hotel.

Representasi JSON 
{
  "placeId": string,
  "finalUrl": string,
  "hotelName": string,
  "callToAction": enum (CallToActionType),
  "textAssets": [
    {
      object (HotelTextAsset)
    }
  ],
  "imageAssets": [
    {
      object (HotelImageAsset)
    }
  ],
  "status": enum (HotelAssetSuggestionStatus)
}
Kolom
placeId

string

ID Google Places hotel.
finalUrl

string

URL final yang disarankan untuk AssetGroup.
hotelName

string

Nama hotel dalam bahasa yang diminta.
callToAction

enum (CallToActionType)

Jenis pesan ajakan (CTA).
textAssets[]

object (HotelTextAsset)

Aset teks seperti judul, deskripsi, dll.
imageAssets[]

object (HotelImageAsset)

Aset gambar seperti lanskap/potret/persegi, dsb.
status

enum (HotelAssetSuggestionStatus)

Status saran aset hotel.

HotelTextAsset

Saran aset teks tunggal untuk hotel.

Representasi JSON 
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
Kolom
text

string

Teks aset dalam bahasa yang diminta.
assetFieldType

enum (AssetFieldType)

Jenis aset teks. Misalnya, HEADLINE, DESCRIPTION, dll.

HotelImageAsset

Saran aset gambar tunggal untuk hotel.

Representasi JSON 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
Kolom
uri

string

URI untuk gambar.
assetFieldType

enum (AssetFieldType)

Jenis aset Gambar. Misalnya, MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE, dll.

HotelAssetSuggestionStatus

Kemungkinan status saran aset hotel.

Enum
UNSPECIFIED Enum tidak ditentukan.
UNKNOWN Kode error yang diterima tidak diketahui pada versi ini.
SUCCESS Saran aset hotel berhasil diambil.
HOTEL_NOT_FOUND Pencarian hotel tidak menghasilkan apa-apa.
INVALID_PLACE_ID ID Google Places tidak valid dan tidak dapat didekode.