- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- HotelAssetSuggestion
- HotelTextAsset
- HotelImageAsset
- HotelAssetSuggestionStatus
- Deneyin.
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 |
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 |
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[] |
Öğ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 ( |
Alanlar | |
---|---|
hotelAssetSuggestions[] |
İ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 ( |
Alanlar | |
---|---|
placeId |
Otelin Google Rehber kimliği. |
finalUrl |
AssetGroup için önerilen nihai URL. |
hotelName |
İstenen dildeki otel adı. |
callToAction |
Harekete geçirici mesaj türü. |
textAssets[] |
Başlık, açıklama gibi metin öğeleri. |
imageAssets[] |
Yatay/dikey/kare gibi resim öğeleri |
status |
Otel öğesi önerisinin durumu. |
HotelTextAsset
Bir otel için tek metin öğesi önerisi.
JSON gösterimi |
---|
{
"text": string,
"assetFieldType": enum ( |
Alanlar | |
---|---|
text |
İstenen dildeki öğe metni. |
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 ( |
Alanlar | |
---|---|
uri |
Resmin URI'si. |
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. |