- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- پیشنهاد هتل دارایی
- HotelTextAsset
- HotelImageAsset
- HotelAssetSuggestionStatus
- آن را امتحان کنید!
پیشنهادات دارایی سفر را برمیگرداند. پیشنهادات دارایی بر اساس بهترین تلاش بازگردانده می شوند. هیچ تضمینی وجود ندارد که تمام انواع داراییهای ممکن برای هر ملک خاص هتل بازگردانده شود.
درخواست HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}:suggestTravelAssets
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
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 Places هتل. |
finalUrl | URL نهایی پیشنهادی برای AssetGroup. |
hotelName | نام هتل به زبان درخواستی |
callToAction | نوع فراخوان برای اقدام |
textAssets[] | دارایی های متنی مانند عنوان، توضیحات و غیره. |
imageAssets[] | دارایی های تصویر مانند منظره / پرتره / مربع و غیره |
status | وضعیت پیشنهاد دارایی هتل. |
HotelTextAsset
پیشنهاد دارایی متنی برای هتل.
نمایندگی JSON |
---|
{
"text": string,
"assetFieldType": enum ( |
زمینه های | |
---|---|
text | متن دارایی به زبان درخواستی |
assetFieldType | نوع دارایی متن به عنوان مثال، عنوان، DESCRIPTION، و غیره. |
HotelImageAsset
پیشنهاد دارایی تصویر واحد برای یک هتل.
نمایندگی JSON |
---|
{
"uri": string,
"assetFieldType": enum ( |
زمینه های | |
---|---|
uri | URI برای تصویر |
assetFieldType | نوع دارایی تصویر به عنوان مثال، MARKETING_IMAGE، PORTRAIT_MARKETING_IMAGE، و غیره. |
HotelAssetSuggestionStatus
وضعیت های احتمالی پیشنهاد دارایی هتل.
Enums | |
---|---|
UNSPECIFIED | تعداد نامشخص |
UNKNOWN | کد خطای دریافتی در این نسخه مشخص نیست. |
SUCCESS | پیشنهاد دارایی هتل با موفقیت بازیابی شد. |
HOTEL_NOT_FOUND | نگاه کردن به هتل چیزی برنمیگرداند. |
INVALID_PLACE_ID | شناسه Google Places نامعتبر است و قابل رمزگشایی نیست. |