- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- HotelAssetSuggestion
- HotelTextAsset
- HotelImageAsset
- HotelAssetSuggestionStatus
- ลองใช้งาน
แสดงคำแนะนำชิ้นงานด้านการเดินทาง ระบบจะแสดงคำแนะนำเนื้อหาอย่างเต็มความสามารถ ไม่มีการรับประกันว่าระบบจะส่งคืนชิ้นงานทุกประเภทที่เป็นไปได้สำหรับที่พักที่ระบุ
คำขอ HTTP
POST https://googleads.googleapis.com/v15/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
HotelAssetSuggestion
ข้อความที่มีคําแนะนําชิ้นงานสําหรับโรงแรม
การแสดง JSON |
---|
{ "placeId": string, "finalUrl": string, "hotelName": string, "callToAction": enum ( |
ช่อง | |
---|---|
placeId |
รหัส Google Places ของโรงแรม |
finalUrl |
URL สุดท้ายที่แนะนำสำหรับ AssetGroup |
hotelName |
ชื่อโรงแรมในภาษาที่ขอ |
callToAction |
ประเภทคำกระตุ้นให้ดำเนินการ (Call-To-Action) |
textAssets[] |
ชิ้นงานข้อความ เช่น บรรทัดแรก คําอธิบาย ฯลฯ |
imageAssets[] |
เนื้อหารูปภาพ เช่น แนวนอน/แนวตั้ง/สี่เหลี่ยมจัตุรัส ฯลฯ |
status |
สถานะของคําแนะนําชิ้นงานโรงแรม |
HotelTextAsset
คําแนะนําเกี่ยวกับชิ้นงานข้อความรายการเดียวสําหรับโรงแรม
การแสดง JSON |
---|
{
"text": string,
"assetFieldType": enum ( |
ช่อง | |
---|---|
text |
ข้อความเนื้อหาในภาษาที่ขอ |
assetFieldType |
ประเภทชิ้นงานข้อความ เช่น HEADLINE, DESCRIPTION ฯลฯ |
HotelImageAsset
คําแนะนําเกี่ยวกับชิ้นงานรูปภาพ 1 รายการสําหรับโรงแรม
การแสดง JSON |
---|
{
"uri": string,
"assetFieldType": enum ( |
ช่อง | |
---|---|
uri |
URI ของรูปภาพ |
assetFieldType |
ประเภทชิ้นงานรูปภาพ ตัวอย่างเช่น MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE ฯลฯ |
HotelAssetSuggestionStatus
สถานะที่เป็นไปได้ของคําแนะนําชิ้นงานโรงแรม
Enum | |
---|---|
UNSPECIFIED |
ไม่ได้ระบุค่า Enum |
UNKNOWN |
ไม่รู้จักรหัสข้อผิดพลาดที่ได้รับในเวอร์ชันนี้ |
SUCCESS |
เรียกข้อมูลคําแนะนําเกี่ยวกับชิ้นงานโรงแรมเรียบร้อยแล้ว |
HOTEL_NOT_FOUND |
การค้นหาโรงแรมไม่พบผลลัพธ์ใดๆ |
INVALID_PLACE_ID |
รหัส Google Places ไม่ถูกต้องและไม่สามารถถอดรหัสได้ |