图谱 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`

关于连线的汇总信息（例如次数总计）。请指定字段来调取概要中的参数（例如：概要=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

错误代码

错误	描述
368	The action attempted has been deemed abusive or is otherwise disallowed
100	Invalid parameter
2500	Error parsing graph query

创建

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

你可以通过下列路径向 hotels 连线发出 POST 请求：

/{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,

}

错误代码

错误	描述
100	Invalid parameter

更新

你无法在此端点执行该操作。

删除

你无法在此端点执行该操作。