- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- ОтельАктивПредложение
- ОтельТекстАссет
- ОтельImageAsset
- ОтельАктивПредложениеСтатус
- Попробуй это!
Возвращает предложения по туристическим активам. Предложения по активам возвращаются по мере возможности. Нет никаких гарантий, что все возможные типы активов будут возвращены для любого конкретного отеля.
HTTP-запрос
POST https://googleads.googleapis.com/v16/customers/{customerId}:suggestTravelAssets
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Необходимый. Идентификатор клиента. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "languageOption": string, "placeIds": [ string ] } |
Поля | |
---|---|
languageOption | Необходимый. Спецификации языка в формате BCP 47 (например, en-US, zh-CN и т. д.) для предложений активов. Текст будет на этом языке. Обычно соответствует одному из целевых языков кампании. |
placeIds[] | Идентификаторы мест отелей Google Maps, для которых запрашиваются ресурсы. Дополнительную информацию см. на странице https://developers.google.com/places/web-service/place-id . |
Тело ответа
Ответное сообщение для TravelAssetSuggestionService.SuggestTravelAssets
.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"hotelAssetSuggestions": [
{
object ( |
Поля | |
---|---|
hotelAssetSuggestions[] | Предложения по объектам для каждого идентификатора места, отправленного в запросе. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .
ОтельАктивПредложение
Сообщение с предложениями по активам для отеля.
JSON-представление |
---|
{ "placeId": string, "finalUrl": string, "hotelName": string, "callToAction": enum ( |
Поля | |
---|---|
placeId | Идентификатор отеля в Google Адресах. |
finalUrl | Рекомендуемый конечный URL для AssetGroup. |
hotelName | Название отеля на запрашиваемом языке. |
callToAction | Тип призыва к действию. |
textAssets[] | Текстовые ресурсы, такие как заголовок, описание и т. д. |
imageAssets[] | Ресурсы изображений, такие как пейзаж/портрет/квадрат и т. д. |
status | Статус предложения по активам отеля. |
ОтельТекстАссет
Однотекстовое предложение объекта для отеля.
JSON-представление |
---|
{
"text": string,
"assetFieldType": enum ( |
Поля | |
---|---|
text | Текст актива на запрошенном языке. |
assetFieldType | Тип текстового ресурса. Например, ЗАГОЛОВОК, ОПИСАНИЕ и т. д. |
ОтельImageAsset
Предложение по одному изображению для отеля.
JSON-представление |
---|
{
"uri": string,
"assetFieldType": enum ( |
Поля | |
---|---|
uri | URI для изображения. |
assetFieldType | Тип ресурса «Изображение». Например, MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE и т. д. |
ОтельАктивПредложениеСтатус
Возможные статусы предложения гостиничного актива.
Перечисления | |
---|---|
UNSPECIFIED | Перечисление не указано. |
UNKNOWN | Полученный код ошибки в этой версии неизвестен. |
SUCCESS | Предложение по объекту отеля успешно получено. |
HOTEL_NOT_FOUND | Поиск отеля ничего не возвращает. |
INVALID_PLACE_ID | Идентификатор Google Адресов недействителен и не может быть расшифрован. |