图谱 API 版

Oembed Post

On April 8, 2025, we introduced a new oEmbed feature, Meta oEmbed Read to replace the existing oEmbed Read feature. The current oEmbed Read feature will be deprecated on November 3, 2025.

Apps created after April 8, 2025 that implement oEmbed will use the new Meta oEmbed Read feature.
Existing apps that already use the current oEmbed Read feature will be automatically updated to the new Meta oEmbed Read feature by November 3, 2025.

The following fields are no longer returned and will be fully deprecated on November 3, 2025:

author_name
author_url
thumbnail_height
thumbnail_url
thumbnail_width

Read the oEmbed Updates blog post from Meta to learn more.

On June 15, 2026, we lifted the access token requirement from all Meta oEmbed APIs. This applies to the following endpoints:

This means that App Review will no longer be required to embed public Meta content. With tokenless access, you can make up to 1,000 oEmbed API requests per endpoint every hour. If you already have the Meta oEmbed Read or Threads oEmbed Read feature approved through App Review, you can still use an access token to make up to 5 million oEmbed API requests per endpoint every day.

Read the Introducing Tokenless Access to Meta oEmbed APIs blog post from Meta to learn more.

读取

OembedPost

例子

Graph API Explorer

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

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

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

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

参数

参数	描述
`maxwidth` int64	Maximum width of returned post.
`omitscript` boolean	默认值：`false` If set to true, the returned embed HTML code will not include any javascript.
`sdklocale` string	sdklocale
`url` URI	The post's URL. 必填
`useiframe` boolean	默认值：`false` useiframe

字段

字段	描述
`height` int32	The height in pixels required to display the HTML. 默认
`html` string	The HTML used to display the post. 默认
`provider_name` string	Name of the provider (Facebook). 默认
`provider_url` string	URL of the provider (Facebook). 默认
`type` string	The oEmbed resource type. See https://oembed.com/. 默认
`version` string	Always 1.0. See https://oembed.com/ 默认
`width` int32	The width in pixels required to display the HTML. 默认

错误代码

错误	描述
100	Invalid parameter
200	Permissions error
190	Invalid OAuth 2.0 Access Token

创建

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

更新

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

删除

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