Method: customers.suggestTravelAssets

Seyahat Öğesi önerilerini döndürür. Öğe önerileri, en iyi çaba esasına göre döndürülür. Belirli bir otel mülkü için olası tüm öğe türlerinin döndürüleceğine dair bir garanti verilmez.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Müşterinin kimliği.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "languageOption": string,
  "placeIds": [
    string
  ]
}
Alanlar
languageOption

string

Zorunlu. Öğe önerileri için BCP 47 biçimindeki dil spesifikasyonları (örneğin, en-US, zh-CN vb.). Metin bu dilde olacaktır. Genellikle kampanya hedef dillerinden biriyle eşleşir.
placeIds[]

string

Öğelerin istendiği otellerin Google Haritalar Yer Kimlikleri. Daha fazla bilgi için https://developers.google.com/places/web-service/place-id adresini ziyaret edin.

Yanıt gövdesi

TravelAssetSuggestionService.SuggestTravelAssets için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "hotelAssetSuggestions": [
    {
      object (HotelAssetSuggestion)
    }
  ]
}
Alanlar
hotelAssetSuggestions[]

object (HotelAssetSuggestion)

İstekte gönderilen her yer kimliği için öğe önerileri.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

HotelAssetSuggestion

Bir otelle ilgili öğe önerilerini içeren mesaj.

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

string

Otelin Google Rehber kimliği.
finalUrl

string

AssetGroup için önerilen nihai URL.
hotelName

string

İstenen dildeki otel adı.
callToAction

enum (CallToActionType)

Harekete geçirici mesaj türü.
textAssets[]

object (HotelTextAsset)

Başlık, açıklama gibi metin öğeleri.
imageAssets[]

object (HotelImageAsset)

Yatay/dikey/kare gibi resim öğeleri
status

enum (HotelAssetSuggestionStatus)

Otel öğesi önerisinin durumu.

HotelTextAsset

Bir otel için tek metin öğesi önerisi.

JSON gösterimi 
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
Alanlar
text

string

İstenen dildeki öğe metni.
assetFieldType

enum (AssetFieldType)

Metin öğesi türü. Örneğin, HEADLINE, DESCRIPTION vb.

HotelImageAsset

Bir otel için tek bir resim öğesi önerisi.

JSON gösterimi 
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
Alanlar
uri

string

Resmin URI'si.
assetFieldType

enum (AssetFieldType)

Resim öğesi türü. Örneğin, MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE vb.

HotelAssetSuggestionStatus

Otel öğesi önerisinin olası durumları.

Sıralamalar
UNSPECIFIED Sıralama belirtilmedi.
UNKNOWN Alınan hata kodu bu sürümde bilinmiyor.
SUCCESS Otel öğesi önerisi başarıyla alındı.
HOTEL_NOT_FOUND Otel araması hiçbir şey döndürmez.
INVALID_PLACE_ID Bir Google Rehber kimliği geçersiz ve bu kimliği çözülemiyor.