图谱 API 版

Event

Represents an Event.

Limitations

Access to Events on Users and Pages is only available to Facebook Marketing Partners.

读取

Get fields and edges on an Event.

Requirements

For Events on an App:

An App access token of an App that created the Event.

For Events on a Group:

A User access token of an Admin of the Event.
The Groups API feature.

例子

Graph API Explorer

GET /v21.0/{event-id} 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(
    '/{event-id}',
    '{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(
    "/{event-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

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

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

如果你希望详细了解如何使用图谱 API，请阅读我们的图谱 API 指南。

参数

这个端点不包含任何参数。

字段

字段	描述
`id` numeric string	The event ID
`attending_count` int32	Number of people attending the event
`can_guests_invite` bool	Can guests invite friends. Requires an access token of an Admin of the Event
`category` enum {CLASSIC_LITERATURE, COMEDY, CRAFTS, DANCE, DRINKS, FITNESS_AND_WORKOUTS, FOODS, GAMES, GARDENING, HEALTH_AND_MEDICAL, HEALTHY_LIVING_AND_SELF_CARE, HOME_AND_GARDEN, MUSIC_AND_AUDIO, PARTIES, PROFESSIONAL_NETWORKING, RELIGIONS, SHOPPING_EVENT, SOCIAL_ISSUES, SPORTS, THEATER, TV_AND_MOVIES, VISUAL_ARTS}	The category of the event
`cover` CoverPhoto	Cover picture
`created_time` datetime	created_time
`declined_count` int32	Number of people who declined the event
`description` string	Long-form description 默认
`discount_code_enabled` bool	Is discount code enabled for this event
`end_time` string	End time, if one has been set 默认
`event_times` list<ChildEvent>	Array of times of a multi-instance event 默认
`guest_list_enabled` bool	Can see guest list. Requires an access token of an Admin of the Event
`interested_count` int32	Number of people interested in the event
`is_canceled` bool	Whether or not the event has been marked as canceled
`is_draft` bool	Whether the event is in draft mode or published. Requires an access token of an Admin of the Event
`is_online` bool	Whether the event is online or not. Required to pass the 'address' (city name) parameter for online events.
`is_page_owned` bool	Whether the event is created by page or not
`maybe_count` int32	Number of people who maybe going to the event
`name` string	Event name 默认
`noreply_count` int32	Number of people who did not reply to the event
`online_event_format` enum {messenger_room, third_party, fb_live, horizon_world, other, none}	Type of online event - Live, Link or Other
`online_event_third_party_url` string	Third party streaming url associated with Link events
`owner`	The profile that created the event
`place` Place	Event Place information 默认
`scheduled_publish_time` string	Time when event is scheduled to be published
`start_time` string	Start time 默认
`ticket_uri` string	The link users can visit to buy a ticket to this event
`ticket_uri_start_sales_time` string	Time when tickets go on sale
`ticketing_privacy_uri` string	URI to seller's privacy policy for ticket purchases
`ticketing_terms_uri` string	URI to seller's terms of service for ticket purchases
`timezone` enum	Timezone
`type` enum {private, public, group, community, friends, work_company}	The type of the event
`updated_time` datetime	Last update time (ISO 8601 formatted)

连线

连线描述

连线	描述
`roles` Edge<Profile>	List of profiles having roles on the event. Requires an access token of an Admin of the Event
`ticket_tiers` Edge<EventTicketTier>	List of ticket tiers. Requires an access token of an Admin of the Event

roles

Edge<Profile>

List of profiles having roles on the event. Requires an access token of an Admin of the Event

ticket_tiers

Edge<EventTicketTier>

List of ticket tiers. Requires an access token of an Admin of the Event

错误代码

错误	描述
100	Invalid parameter
200	Permissions error
458	The session is invalid because the application is not installed
368	The action attempted has been deemed abusive or is otherwise disallowed
190	Invalid OAuth 2.0 Access Token
104	Incorrect signature

创建

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

更新

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

删除

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