圖形 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

閱讀中

Endpoint that returns the hotels from a catalog

範例

Graph API Explorer

GET /v19.0/{product-catalog-id}/hotels HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{product-catalog-id}/hotels',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{product-catalog-id}/hotels",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{product-catalog-id}/hotels",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{product-catalog-id}/hotels"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

如果想瞭解如何使用圖形 API，請參閱我們的使用圖形 API 指南。

參數

參數說明

參數	說明
`bulk_pagination` boolean	Used for iterating over the edge in large chunks
`filter` A JSON-encoded rule	JSON-encoded WCA rule expression representing the filter to be applied for the edge

bulk_pagination

boolean

Used for iterating over the edge in large chunks

filter

A JSON-encoded rule

JSON-encoded WCA rule expression representing the filter to be applied for the edge

欄位

由此關係連線進行的閱讀將回傳 JSON 格式結果：

{
    "data": [],
    "paging": {},
    "summary": {}
}

`data`

Hotel 節點的清單。

`paging`

如需更多有關分頁的詳細資料，請參閱圖形 API 指南。

`summary`

與關係連線相關的彙總資訊，例如次數等。請在摘要參數中指定要擷取的欄位（例如 summary=total_count）。

欄位說明

欄位	說明
`total_count` unsigned int32	Total number of hotels returned by the query

total_count

unsigned int32

Total number of hotels returned by the query

Error Codes

錯誤	說明
368	The action attempted has been deemed abusive or is otherwise disallowed
100	Invalid parameter

建立中

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

更新中

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

刪除中

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