Method: customers.suggestTravelAssets

Возвращает предложения по туристическим активам. Предложения по активам возвращаются по мере возможности. Нет никаких гарантий, что все возможные типы активов будут возвращены для любого конкретного отеля.

HTTP-запрос

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

ОтельАктивПредложение

Сообщение с предложениями по активам для отеля.

JSON-представление
{
  "placeId": string,
  "finalUrl": string,
  "hotelName": string,
  "callToAction": enum (CallToActionType),
  "textAssets": [
    {
      object (HotelTextAsset)
    }
  ],
  "imageAssets": [
    {
      object (HotelImageAsset)
    }
  ],
  "status": enum (HotelAssetSuggestionStatus)
}
Поля
placeId

string

Идентификатор отеля в Google Адресах.

finalUrl

string

Рекомендуемый конечный URL для AssetGroup.

hotelName

string

Название отеля на запрашиваемом языке.

callToAction

enum ( CallToActionType )

Тип призыва к действию.

textAssets[]

object ( HotelTextAsset )

Текстовые ресурсы, такие как заголовок, описание и т. д.

imageAssets[]

object ( HotelImageAsset )

Ресурсы изображений, такие как пейзаж/портрет/квадрат и т. д.

status

enum ( HotelAssetSuggestionStatus )

Статус предложения по активам отеля.

ОтельТекстАссет

Однотекстовое предложение объекта для отеля.

JSON-представление
{
  "text": string,
  "assetFieldType": enum (AssetFieldType)
}
Поля
text

string

Текст актива на запрошенном языке.

assetFieldType

enum ( AssetFieldType )

Тип текстового ресурса. Например, ЗАГОЛОВОК, ОПИСАНИЕ и т. д.

ОтельImageAsset

Предложение по одному изображению для отеля.

JSON-представление
{
  "uri": string,
  "assetFieldType": enum (AssetFieldType)
}
Поля
uri

string

URI для изображения.

assetFieldType

enum ( AssetFieldType )

Тип ресурса «Изображение». Например, MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE и т. д.

ОтельАктивПредложениеСтатус

Возможные статусы предложения гостиничного актива.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
SUCCESS Предложение по объекту отеля успешно получено.
HOTEL_NOT_FOUND Поиск отеля ничего не возвращает.
INVALID_PLACE_ID Идентификатор Google Адресов недействителен и не может быть расшифрован.