圖形 API 版本

Product Catalog Hotels

Hotels in a catalog used in Dynamic Ads for Travel. See Dynamic Ads for Travel, Catalog Setup.

When you use this, you can provide Batch Requests to combine a number of API calls into one HTTP request.

For example, to get the total number of hotels in a catalog:

curl -G \
-d "summary=total_count" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/hotels

To fetch hotels whose name contains "suites":

curl -G \
-d 'fields=["hotel_id","name"]' \
-d 'filter={"name":{"i_contains":"suites"}}' \
-d 'access_token=<ACCESS_TOKEN>'
https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/hotels

閱讀中

你無法在此端點執行此操作。

建立中

Example

Example to create a hotel:

curl \
-X POST \
-F "hotel_id=h_157" \
-F "name=Sample Hotel" \
-F "images= [ \
  {'image_url':'http://www.example.com/pic1.jpg', 'tags':['front view']}, \
  {'image_url':'http://www.example.com/pic2.jpg', 'tags':['lobby view']} \
]" \
-F "url=http://www.example.com/samplehotel" \
-F "address={ \
  street_address:'1 Hacker Way', \
  city:'Menlo Park', \
  region:'California', \
  country:'United States', \
  postal_code:'94025', \
  neighborhoods:['Palo Alto','Menlo Park'], \
  latitude:37.484116, \
  longitude:-122.148244 \
}" \
-F "brand=hotel brand" \
-F "description=hotel description" \
-F "guest_ratings= [ \
  {'score':7.8, 'rating_system':'sample_rating', 'number_of_raters':780} \
]" \
-F "star_rating=4" \
-F "loyalty_program=Sample rewards club" \
-F "phone=+351234123456" \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/hotels

You can make a POST request to hotels edge from the following paths:

/{product_catalog_id}/hotels

發佈到此關係連線時，會建立 a Hotel 。

參數

參數	說明
`address` Object	The address of the hotel 必填
`city` string	必填
`city_id` string
`country` string	必填
`latitude` float	必填
`longitude` float	必填
`neighborhoods` list<string>
`postal_code` string
`region` string	必填
`street_address` string	必填
`applinks` Object	App links for native platforms, e.g. Android, IOS and Windows Phone.
`web`
`android`
`ios`
`ipad`
`iphone`
`windows_phone`
`base_price` int64	The base price of the hotel
`brand` string	Hotel brand
`currency` ISO 4217 Currency Code	預設值：`USD` The currency for base_price, e.g. USD
`description` string	Description of the hotel 必填
`guest_ratings` list<Object>	Guest ratings for this hotel.
`score` float	必填
`max_score` int64	必填
`rating_system` string	必填
`number_of_raters` int64	必填
`hotel_id` string	A unique identifier for this hotel provided by advertiser. (i.e. from the `id` field in the feed
`images` list<Object>	Links to hotel images. Please note that carousel format utilizes a square 1:1 aspect ratio images (recommended size - 600x600px) while single hotel ad uses 1.91:1 aspect ratio image(recommended size - 1200x630px). Please provide at least one image. 必填
`image_url` URL	必填
`tags` list<string>
`name` string	Name of the hotel 必填
`phone` phone number string	Hotel's phone number
`star_rating` float	The star rating of the hotel
`url` URL	Link to the external site where you can book a hotel room 必填

傳回類型

此端點支援寫入後讀取功能，並將讀取傳回類型表示為 id 的節點。

Struct {

id: numeric string,

}

Error Codes

錯誤	說明
100	Invalid parameter

更新中

你無法在此端點執行此操作。

刪除中

你無法在此端點執行此操作。