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Đọc
Tạo
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>/hotelshotels từ các đường dẫn sau: Thông số
| Thông số | Mô tả |
|---|---|
addressObject | The address of the hotel Bắt buộc |
applinksObject | App links for native platforms, e.g. Android, IOS and Windows Phone. |
base_priceint64 | The base price of the hotel |
brandstring | Hotel brand |
currencyISO 4217 Currency Code | Giá trị mặc định: USDThe currency for base_price, e.g. USD |
descriptionstring | Description of the hotel Bắt buộc |
guest_ratingslist<Object> | Guest ratings for this hotel. |
hotel_idstring | A unique identifier for this hotel provided by advertiser. (i.e. from the |
imageslist<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. Bắt buộc |
namestring | Name of the hotel Bắt buộc |
phonephone number string | Hotel's phone number |
star_ratingfloat | The star rating of the hotel |
urlURL | Link to the external site where you can book a hotel room Bắt buộc |
Kiểu trả về
id in the return type.id: numeric string, Mã lỗi
| Lỗi | Mô tả |
|---|---|
| 100 | Invalid parameter |