Facebook [已弃用]

Facebook API 允许你在 Facebook 用户帐户上访问和发布帖子

此连接器在以下产品和区域中可用：

服务	Class	区域
逻辑应用程序	标准	除以下各项外的所有 逻辑应用区域 ：      - Azure 中国区域
Power Automate	标准	除以下各项外的所有 Power Automate 区域 ：      - 美国政府 （GCC High）      - 由世纪互联运营的中国云
Power Apps	标准	除以下各项外的所有 Power Apps 区域 ：      - 美国政府 （GCC High）      - 由世纪互联运营的中国云

联系人​​
Name	Microsoft
URL	Microsoft LogicApps 支持 Microsoft Power Automate 支持 Microsoft Power Apps 支持

连接器元数据
发布者	Microsoft
网站	https://www.facebook.com/
隐私策略	https://www.facebook.com/privacy/explanation

此连接器已弃用。 我们将其替换为一个开源 示例 ，用户可以将其扩展并部署为 自定义连接器 。

若要使用此集成，需要一个 Facebook 帐户。

已知问题和限制

1. 当 时间线上有一个新帖子 时，只有帐户所有者将帖子添加到时间线时，触发器就会触发。
2. 当 时间线上有一个新帖子 在 LogicApps 区域中不起作用时，触发器。 我们正在用Facebook来解决问题。

限制

名称	调用	续订期
每个连接的 API 调用数	500	300 秒
触发器轮询的频率	1	120 秒

操作

从我的时间线获取源 [已弃用]	从已登录用户的时间线获取源。
从我的时间线获取源 （V2） [已弃用]	从登录的用户时间线（V2）获取源。
发布到我的时间线 [已弃用]	将状态消息发布到已登录用户的日程表。
发布到页面 [已弃用]	将消息作为登录用户发布到 Facebook 页面。
发布到页面 （V2） [已弃用]	将消息作为登录用户（V2）发布到 Facebook 页面。
获取用户或页面时间线 [已弃用]	从用户或页面时间线获取帖子。
获取用户时间线 [已弃用]	从用户的日程表获取帖子。
获取用户时间线 （V2） [已弃用]	从用户的日程表（V2）获取帖子。
获取页面源 （V2） [已弃用]	从指定页面的源获取文章（V2）。
获取页面源 （V3） [已弃用]	从指定页面的源获取文章（V3）。

从我的时间线获取源 [已弃用]

操作 ID:

MyTimeline

从已登录用户的时间线获取源。

参数

名称	密钥	必需	类型	说明
Fields	fields		string	指定要返回的字段。 示例（id，name，picture）。
最大帖子数	limit		integer	要检索的最大帖子数。
带或不带位置	with		string	将帖子列表限制为仅附加位置的帖子列表。
筛选返回的源	filter		string	仅检索与特定流筛选器匹配的帖子。

返回

源项列表。

饲料

GetFeedResponse

从我的时间线获取源 （V2） [已弃用]

操作 ID:

MyTimelineV2

从登录的用户时间线（V2）获取源。

参数

名称	密钥	必需	类型	说明
Fields	fields		string	指定要返回的字段。 示例（id，name，picture）。
最大帖子数	limit		integer	要检索的最大帖子数。
带或不带位置	with		string	将帖子列表限制为仅附加位置的帖子列表。
筛选返回的源	filter		string	仅检索与特定流筛选器匹配的帖子。

返回

源项列表。

饲料

GetFeedResponse

发布到我的时间线 [已弃用]

操作 ID:

PostToMyTimeline

将状态消息发布到已登录用户的日程表。

参数

名称	密钥	必需	类型	说明
状态消息	message	True	string	帖子的主体，否则称为状态消息。
发布链接	link		uri	要附加到帖子的链接的 URL。
链接图像	picture		uri	确定与链接关联的预览图像。
链接名称	name		string	覆盖链接预览的标题。
链接标题	caption		string	覆盖链接预览中标题下的标题。
链接说明	description		string	覆盖链接预览中的说明。
发布位置	place		string	与此文章关联的位置的页面 ID。
标记的用户	tags		string	此帖子中标记的用户 ID 的逗号分隔列表。
隐私设置说明	description		string	描述隐私设置的文本，如 Facebook 中所示。
隐私价值	value	True	string	隐私设置的值。
允许的用户	allow		string	值为 CUSTOM 时，这是一个逗号分隔的用户 ID 列表和可查看帖子的朋友列表 ID。
被拒绝的用户	deny		string	如果值为 CUSTOM，则这是用户 ID 和好友列表 ID 的逗号分隔列表，看不到帖子。
被拒绝的朋友	friends		string	如果值为 CUSTOM，则表示哪些好友可以查看帖子。
缩略图图片 ID	object_attachment		string	要用作缩略图的人相册中现有图片的 Facebook ID。

返回

发布到源的项目的详细信息。

已发布项目

PostFeedResponse

发布到页面 [已弃用]

操作 ID:

PostToPage

将消息作为登录用户发布到 Facebook 页面。

参数

名称	密钥	必需	类型	说明
页面 ID	objectId	True	string	要发布到的页面的唯一 ID。
状态消息	message	True	string	帖子的主体，否则称为状态消息。
发布链接	link		uri	要附加到帖子的链接的 URL。
链接图像	picture		uri	确定与链接关联的预览图像。
链接名称	name		string	覆盖链接预览的标题。
链接标题	caption		string	覆盖链接预览中标题下的标题。
链接说明	description		string	覆盖链接预览中的说明。
作链接名称	name		string	作链接的名称或标签。
操作链接	link		string	作链接本身的 URL。
发布位置	place		string	与此文章关联的位置的页面 ID
标记用户	tags		string	此帖子中标记的用户 ID 的逗号分隔列表。
缩略图图片 ID	object_attachment		string	要用作缩略图的人相册中现有图片的 Facebook ID。
国家/地区代码	Targetted countries		string
区域设置代码	Targetted locales		integer
区域代码	Targetted regions		integer
城市代码	Excluded cities		integer
国家/地区代码	Targetted countries		string
区域代码	Targetted regions		integer
城市代码	Excluded cities		integer
最低年龄	age_min		integer	必须为 13 或更高版本。
最大年龄	age_max		integer	最大年龄。
性别代码。 对男性使用 1，对女性使用 2。	Targetted genders		integer
关系状态。 将 1 用于单身，2 用于“在关系中”，3 个用于已婚，4 个用于订婚。	Targetted relationship statuses		integer
兴趣代码。 使用 1 表示男性，2 表示女性。	Targetted interests		integer
毕业年份	Targetted college graduation year		integer
教育状态代码。 将 1 用于高中、2 个用于本科生，3 个用于校友（或本地化等效项）。	Targetted education statuses		integer
区域设置代码	Targetted locales		integer
发布文章。	published		boolean	是否显示有关此新发布的对象的故事。
计划发布时间	scheduled_publish_time		date-time	发布此帖子的时间可能介于 10 分钟到 6 个月的 API 调用时间之间。
返回日期时间。	backdated_time		date-time	指定过去一段时间，以将此帖子备份到此时间。
后退时间显示格式。	backdated_time_granularity		string	控制回退帖子的显示方式。
附件链接	link		string	要附加到帖子的链接的 URL。
链接图片	picture		uri	确定与链接关联的预览图像（1：1 纵横比和至少 458 x 458 像素）以获得最佳显示效果。
图像哈希	image_hash		string	与广告图像库中的链接关联的预览图像的哈希（1：1 纵横比和至少 458 x 458 像素，以获得最佳显示效果）。
链接名称	name		string	链接预览的标题。
链接说明	description		string	用于显示价格、折扣或网站域。
多共享端卡	multi_share_end_card		boolean	如果设置为 false，则使用child_attachments时不显示轮播链接帖子的结束卡。

返回

发布到源的项目的详细信息。

已发布项目

PostFeedResponse

发布到页面 （V2） [已弃用]

操作 ID:

PostToPageV2

将消息作为登录用户（V2）发布到 Facebook 页面。

参数

名称	密钥	必需	类型	说明
页面 ID	pageId	True	string	要发布到的页面的唯一 ID。
状态消息	message	True	string	帖子的主体，否则称为状态消息。
发布链接	link		uri	要附加到帖子的链接的 URL。
链接图像	picture		uri	确定与链接关联的预览图像。
链接名称	name		string	覆盖链接预览的标题。
链接标题	caption		string	覆盖链接预览中标题下的标题。
链接说明	description		string	覆盖链接预览中的说明。
作链接名称	name		string	作链接的名称或标签。
操作链接	link		string	作链接本身的 URL。
发布位置	place		string	与此文章关联的位置的页面 ID
标记用户	tags		string	此帖子中标记的用户 ID 的逗号分隔列表。
缩略图图片 ID	object_attachment		string	要用作缩略图的人相册中现有图片的 Facebook ID。
国家/地区代码	Targetted countries		string
位置键	key		string	目标位置项的键。
区域设置代码	Targetted locales		integer
国家/地区代码	Targetted countries		string
位置键	key		string	目标位置项的键。
最低年龄	age_min		integer	必须为 13 或更高版本。
最大年龄	age_max		integer	最大年龄。
性别代码。 对男性使用 1，对女性使用 2。	Targetted genders		integer
关系状态。 将 1 用于单身，2 用于“在关系中”，3 个用于已婚，4 个用于订婚。	Targetted relationship statuses		integer
兴趣代码。 使用 1 表示男性，2 表示女性。	Targetted interests		integer
毕业年份	Targetted college graduation year		integer
教育状态代码。 将 1 用于高中、2 个用于本科生，3 个用于校友（或本地化等效项）。	Targetted education statuses		integer
区域设置代码	Targetted locales		integer
发布文章。	published		boolean	是否显示有关此新发布的对象的故事。
计划发布时间	scheduled_publish_time		date-time	发布此帖子的时间可能介于 10 分钟到 6 个月的 API 调用时间之间。
返回日期时间。	backdated_time		date-time	指定过去一段时间，以将此帖子备份到此时间。
后退时间显示格式。	backdated_time_granularity		string	控制回退帖子的显示方式。
附件链接	link		string	要附加到帖子的链接的 URL。
链接图片	picture		uri	确定与链接关联的预览图像（1：1 纵横比和至少 458 x 458 像素）以获得最佳显示效果。
图像哈希	image_hash		string	与广告图像库中的链接关联的预览图像的哈希（1：1 纵横比和至少 458 x 458 像素，以获得最佳显示效果）。
链接名称	name		string	链接预览的标题。
链接说明	description		string	用于显示价格、折扣或网站域。
多共享端卡	multi_share_end_card		boolean	如果设置为 false，则使用child_attachments时不显示轮播链接帖子的结束卡。

返回

发布到源的项目的详细信息。

已发布项目

PostFeedResponse

获取用户或页面时间线 [已弃用]

操作 ID:

ObjectFeed

从用户或页面时间线获取帖子。

参数

名称	密钥	必需	类型	说明
用户 ID	objectId	True	string	必须检索其时间线的用户或页面的唯一 ID。
最大帖子数	limit		integer	要检索的最大帖子数。
带或不带位置	with		string	将帖子列表限制为仅附加位置的帖子列表。
包括隐藏帖子	include_hidden		boolean	是否包括页面隐藏的任何帖子。
Fields	fields		string	指定要返回的字段。 示例（id，name，picture）。

返回

源项列表。

饲料

GetFeedResponse

获取用户时间线 [已弃用]

操作 ID:

UserTimeline

从用户的日程表获取帖子。

参数

名称	密钥	必需	类型	说明
用户 ID	userId	True	string	必须检索其时间线的用户的唯一 ID。
最大帖子数	limit		integer	要检索的最大帖子数。
带或不带位置	with		string	将帖子列表限制为仅附加位置的帖子列表。
Fields	fields		string	指定要返回的字段。 示例（id，name，picture）。

返回

源项列表。

饲料

GetFeedResponse

获取用户时间线 （V2） [已弃用]

操作 ID:

UserTimelineV2

从用户的日程表（V2）获取帖子。

参数

名称	密钥	必需	类型	说明
用户 ID	userId	True	string	必须检索其时间线的用户的唯一 ID。
最大帖子数	limit		integer	要检索的最大帖子数。
带或不带位置	with		string	将帖子列表限制为仅附加位置的帖子列表。
Fields	fields		string	指定要返回的字段。 示例（id，name，picture）。

返回

源项列表。

饲料

GetFeedResponse

获取页面源 （V2） [已弃用]

操作 ID:

PageFeedV2

从指定页面的源获取文章（V2）。

参数

名称	密钥	必需	类型	说明
页面 ID	pageId	True	string	必须从中检索文章的页面的唯一 ID。
最大帖子数	limit		integer	要检索的最大帖子数。
包括隐藏帖子	include_hidden		boolean	是否包括页面隐藏的任何帖子。
Fields	fields		string	指定要返回的字段。 示例（id，name，picture）。

返回

源项列表。

饲料

GetFeedResponse

获取页面源 （V3） [已弃用]

操作 ID:

PageFeedV3

从指定页面的源获取文章（V3）。

参数

名称	密钥	必需	类型	说明
页面 ID	pageId	True	string	必须从中检索文章的页面的唯一 ID。
最大帖子数	limit		integer	要检索的最大帖子数。
包括隐藏帖子	include_hidden		boolean	是否包括页面隐藏的任何帖子。
Fields	fields		string	指定要返回的字段。 示例（id，name，picture）。

返回

源项列表。

饲料

GetFeedResponse

触发器

当时间线上有一个新帖子 [已弃用]

在登录用户的日程表上有新帖子时，触发新流。 服务检测帖子的能力必须通过多个隐私检查，包括 Facebook 上的个人隐私设置。 因此，此触发器可能不对所有帖子激活。

当时间线上有一个新帖子 [已弃用]

操作 ID:

TriggerNewPost

在登录用户的日程表上有新帖子时，触发新流。 服务检测帖子的能力必须通过多个隐私检查，包括 Facebook 上的个人隐私设置。 因此，此触发器可能不对所有帖子激活。

返回

新创建的帖子列表。

时间线源

TriggerFeedResponse

定义

GetFeedResponse

源项列表。

名称	路径	类型	说明
响应数据	data	array of PostItem

TriggerFeedResponse

新创建的帖子列表。

名称	路径	类型	说明
响应数据	data	array of TriggerItem

PostItem

配置文件源中的单个条目。 配置文件可以是用户、页面、应用或组。

名称	路径	类型	说明
发布 ID	id	string	帖子的唯一 ID。
管理员创建者	admin_creator	array of AdminItem	创建帖子的管理员的唯一 ID。 仅适用于页面。
链接标题	caption	string	帖子中链接的标题（显示在名称下方）。
已创建 Date-Time	created_time	date-time	帖子最初发布的时间。 对于有关生活事件的帖子，这是生命事件的日期和时间。
链接说明	description	string	帖子中链接的说明（显示在标题下方）。
新闻源目标	feed_targeting	FeedTargetItem	控制此帖子的新闻源目标的对象。 这些组中的任何人都更有可能看到此帖子，其他人不太可能看到。 仅适用于页面。
用户	from	UserItem	特定 Facebook 用户的详细信息。
图标链接	icon	string	指向表示此文章类型的图标的链接。
是否隐藏？	is_hidden	boolean	如果此文章标记为隐藏（仅适用于页面）。
是否已发布？	is_published	boolean	指示计划的帖子是否已发布（仅适用于计划的页面帖子，对于用户帖子和实例发布帖子，此值始终为 true）。
链接 URL	link	uri	附加到此文章的链接。
状态消息	message	string	帖子中的状态消息。
Name	name	string	链接的名称。
媒体 ID	object_id	string	附加到帖子的任何上传的照片或视频的 ID。
图像 URL	picture	uri	图片从帖子中包含的任何链接中擦除。
place	place	PlaceItem
隐私	privacy	PrivacyItem
发布属性	properties	array of PropertyItem	任何附加视频的属性列表，例如视频的长度。
视频源	source	uri	附加到帖子的任何 Flash 电影或视频文件的 URL。
状态更新类型	status_type	string	状态更新类型的说明。
故事文本	story	string	用户不会故意生成的故事中的文本，例如当两个人成为朋友时生成的文字，或者其他人在人员墙上发帖时生成的文本。
针对	targeting	TargetItem
到	to	array of ProfileCollection	此文章中提到的或面向的配置文件。
帖子类型	type	string	一个字符串，指示此帖子的对象类型。
上次更新时间	updated_time	date-time	上次更改此文章的时间，或对此文章的评论。
with_tags	with_tags	ProfileCollection
介质	media	array of uri

TriggerItem

配置文件源中的单个条目。 配置文件可以是用户、页面、应用或组。

名称	路径	类型	说明
发布 ID	id	string	帖子 ID。
创建时间	created_time	date-time	帖子最初发布的时间。 对于有关生活事件的帖子，这是生命事件的日期和时间。
用户	from	UserItem	特定 Facebook 用户的详细信息。
状态消息	message	string	帖子中的状态消息。
帖子类型	type	string	一个字符串，指示此帖子的对象类型。
图像 URL	picture	uri	图片从帖子中包含的任何链接中擦除。
链接 URL	link	uri	附加到此文章的链接。
Name	name	string	链接的名称。
链接说明	description	string	帖子中链接的说明（显示在标题下方）。
介质	media	array of uri

AdminItem

名称	路径	类型	说明
用户 ID	id	integer	管理员用户的唯一 ID。
管理员全名	name	string	管理员的名称。

PropertyItem

名称	路径	类型	说明
属性名称	name	string	属性名称。
属性值	text	string	属性的值。
属性链接	href	uri	与属性关联的任何链接。

PostFeedResponse

发布到源的项目的详细信息。

名称	路径	类型	说明
发布 ID	id	string

ProfileCollection

名称	路径	类型	说明
数据	data	array of UserItem

UserItem

特定 Facebook 用户的详细信息。

名称	路径	类型	说明
用户 ID	id	string	用户的唯一 ID。
名字	first_name	string	用户名。
姓氏	last_name	string	用户名。
全名	name	string	用户全名。
性别	gender	string	用户的性别。
用户生物	about	string	用户生物页面的正文。

TargetItem

名称	路径	类型	说明
目标国家/地区	countries	array of string	目标国家/地区的值。
目标区域设置	locales	array of integer	目标区域设置。
目标区域	regions	array of integer	目标区域的值。
排除的城市	cities	array of integer	排除城市的值。

FeedTargetItem

控制此帖子的新闻源目标的对象。 这些组中的任何人都更有可能看到此帖子，其他人不太可能看到。 仅适用于页面。

名称	路径	类型	说明
目标国家/地区	countries	array of string	目标国家/地区的值。
目标区域	regions	array of integer	目标区域的值。
排除的城市	cities	array of integer	排除城市的值。
最低年龄	age_min	integer	必须为 13 或更高版本。
最大年龄	age_max	integer	最大年龄。
目标性别	genders	array of integer	以特定性别为目标。 1 个面向所有男性观众和 2 名女性。 默认值为同时面向这两者。
目标关系状态	relationship_statuses	array of integer	用于基于关系状态的整数数组。
目标兴趣	interested_in	array of integer	根据用户配置文件的“感兴趣的”字段指示目标。
定向大学毕业年	college_years	array of integer	大学毕业年份的整数数组。
目标教育状态	education_statuses	array of integer	用于基于教育级别的整数数组。
目标区域设置	locales	array of integer	目标区域设置。

PlaceItem

名称	路径	类型	说明
放置 ID	id	string	位置的唯一 ID
嵙	name	string	位置的名称
放置分级	overall_rating	float	总体位置评级，以 5 星级的规模。 0 表示没有足够的数据来获得合并的分级。
位置	location	LocationItem

LocationItem

名称	路径	类型	说明
城市名称	city	string	城市位置。
国家/地区名称	country	string	位置的国家/地区。
Latitude	latitude	float	位置的纬度。
位于	located_in	string	如果此位置位于其他位置，则为父位置。
Longitude	longitude	float	位置的经度。
位置名称	name	string	位置的名称。
区域名称	region	string	位置区域的名称。
州名称	state	string	位置所在的状态。
街道名称	street	string	该位置所在的街道。
Zipcode	zip	string	位置邮政编码。

PrivacyItem

名称	路径	类型	说明
隐私设置说明	description	string	描述隐私设置的文本，如 Facebook 中所示。
隐私价值	value	string	隐私设置的值。
允许的用户	allow	string	值为 CUSTOM 时，这是一个逗号分隔的用户 ID 列表和可查看帖子的朋友列表 ID。
被拒绝的用户	deny	string	如果值为 CUSTOM，则这是用户 ID 和好友列表 ID 的逗号分隔列表，看不到帖子。
被拒绝的朋友	friends	string	如果值为 CUSTOM，则表示哪些好友可以查看帖子。