用户

Shopify Plus

用户资源仅适用于Shopify Plus商店中安装的私人应用程序。请联系Shopify Plus支持以为您的商店启用此API资源。

用户资源可让您检索有关Shopify商店中员工帐户的信息。

商店所有者可以添加，删除和编辑员工帐户。具有完全权限的工作人员只能编辑其他工作人员帐户的权限，而具有单独权限的工作人员只能编辑自己的工作人员帐户。该API仅允许您检索有关员工帐户的信息。

用户可以做什么

Shopify API使您可以对用户资源执行以下操作。这些常规操作的更详细的版本可能可用：

用户属性

帐户所有者 plain "account_owner": false 用户是否是Shopify帐户的所有者。
生物 plain "bio": "A person on a mission" 用户为自己写的描述。
电子邮件 plain "email": "joe@example.com" 用户的电子邮件地址。
名 plain "first_name": "Joe" 用户的名字。
ID plain "id": 1234567890 用户员工帐户的ID。
我是 plain "im": "joe-chat@example.com" 用户的IM帐户地址。
姓 plain "last_name": "Smith" 用户的姓氏。
权限 plain "permissions": [ "full" ] 用户的工作人员帐户具有的权限。用户将具有full权限或特定权限列表。有效值：
+ full：用户具有与帐户所有者相同的权限，但有一些例外，例如修改帐户帐单或删除员工帐户。
+ 仪表板：用户可以查看有关商店绩效的统计信息。
+ 订单：用户可以查看和修改订单。
+ 客户：用户可以查看和修改客户。
+ 市场营销：用户可以查看和修改与市场营销相关的产品，例如折扣代码。
+ 产品：用户可以查看和修改产品。
+ gift_cards：用户可以查看和修改礼品卡。
+ pages：用户可以查看和修改商店页面。
+ 链接：用户可以查看和修改链接和菜单。
+ 主题：用户可以查看和修改商店主题。
+ 应用程序：用户可以授权安装第三方应用程序。
+ 首选项：用户可以查看商店的首选项和配置。
+ 报告：用户可以查看和创建报告。
电话 plain "phone": "(555) 555-5555" 用户的电话号码。
receive_announcements plain "receive_announcements": 0 此帐户是否将收到Shopify的电子邮件通知。有效值：0，1
屏幕名称 不推荐使用 plain "screen_name": "joesmith" 不推荐使用此属性。
网址 plain "url": "http://example.com" 用户的主页或其他网址。
地区 plain "locale": "en" 用户的首选语言环境。语言环境值使用language或格式language-COUNTRY，其中language是两个字母的语言代码，并且COUNTRY是两个字母的国家代码。例如：en或en-US
用户类型 plain "user_type": "regular" 用户拥有的帐户类型。有效值：
+ 常规：用户帐户可以访问Shopify管理员。
+ 受限：用户帐户无法访问Shopify管理员。
+ 受邀：用户尚未接受创建员工帐户的邀请。
+ 协作者：与商家协作的合作伙伴的用户帐户。

终点

得到/admin/api/2021-01/users.json 检索所有用户的列表。注意：从2021-01版本开始，此端点通过使用响应标头中提供的链接来实现分页。发送<font style="background-color:#F4F6F8;">page</font>参数将返回错误。要了解更多信息，请参阅向分页的REST Admin API端点发出请求。
限制 在页面上显示的最大结果数。
（默认值：50
最大：250
）
page_info 用于访问结果页面的唯一ID。

检索所有用户的列表

GET /admin/api/2021-01/users.json

查看回应

得到/admin/api/2021-01/users/{user_id}.json 检索单个用户

检索单个用户

GET /admin/api/2021-01/users/799407056.json

查看回应

得到/admin/api/2021-01/users/current.json 检索有关与用于发出此API请求的访问令牌关联的用户帐户的信息。仅当为商店的特定用户创建访问令牌时，此请求才有效。

检索当前登录的用户

GET /admin/api/2021-01/users/current.json

查看回应