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 mümkün olan tüm öğe türlerinin döndürüleceğine dair herhangi bir garanti verilmez.

HTTP isteği

POST https://googleads.googleapis.com/v15/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

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

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

string

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

string

Varlıkların istendiği otellerin Google Haritalar Yer Kimlikleri. Daha fazla bilgi için https://developers.google.com/places/web-service/place-id adresine bakın.

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

Bir 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 bir metin öğesi önerisi.

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

string

İstenen dilde öğ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 kodu çözülemiyor.