Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
REST Resource: accounts.admins
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
منبع: ادمین
| نمایندگی JSON |
|---|
{
"name": string,
"admin": string,
"account": string,
"role": enum (AdminRole),
"pendingInvitation": boolean
} |
| فیلدها |
|---|
name | string تغییرناپذیر. نام منبع برای مدیران حساب، این به این شکل است: accounts/{account_id}/admins/{admin_id} برای مدیران موقعیت مکانی، این به این شکل است: locations/{locationId}/admins/{admin_id} اگر در حین ایجاد مدیر تنظیم شود، این فیلد نادیده گرفته می شود. |
admin | string اختیاری. نام ادمین. هنگام انجام دعوت اولیه، این آدرس ایمیل دعوت شده است. در تماس‌های GET ، اگر دعوت‌نامه هنوز معلق باشد، آدرس ایمیل کاربر برگردانده می‌شود. در غیر این صورت، شامل نام و نام خانوادگی کاربر است. این فیلد فقط باید در حین ایجاد ادمین تنظیم شود. |
account | string تغییرناپذیر. نام منبع حسابی که این مدیر به آن اشاره دارد. هنگام تماس با locations.admins.create برای دعوت از LocationGroup به عنوان سرپرست استفاده می شود. اگر این فیلد و admin هر دو روی درخواست‌های CREATE تنظیم شده باشند، این فیلد اولویت دارد و آدرس ایمیل موجود در admin نادیده گرفته می‌شود. قالب: accounts/{account} . |
role | enum ( AdminRole ) مورد نیاز. نقشی را که این سرپرست با حساب یا مکان مشخص شده استفاده می‌کند، مشخص می‌کند. |
pendingInvitation | boolean فقط خروجی نشان می دهد که آیا این سرپرست دعوت نامه معلقی برای منبع مشخص شده دارد یا خیر. |
نقش مدیر
| Enums |
|---|
ADMIN_ROLE_UNSPECIFIED | مشخص نشده است. |
PRIMARY_OWNER | ادمین دسترسی در سطح مالک دارد و مالک اصلی است. (به عنوان "مالک اصلی" در UI نمایش داده می شود). |
OWNER | ادمین دسترسی در سطح مالک دارد. (به عنوان "مالک" در UI نمایش داده می شود). |
MANAGER | ادمین دسترسی مدیریتی دارد. |
SITE_MANAGER | ادمین می تواند صفحات اجتماعی (Google+) را مدیریت کند. (به عنوان "مدیر سایت" در UI نمایش داده می شود). این API اجازه ایجاد یک سرپرست حساب با نقش SITE_MANAGER را نمی دهد. |
روش ها |
|---|
| کاربر مشخص شده را دعوت می کند تا مدیر حساب مشخص شده شود. |
| ادمین مشخص شده را از حساب مشخص شده حذف می کند. |
| ادمین های حساب مشخص شده را لیست می کند. |
| Admin را برای مدیریت حساب مشخص شده به روز می کند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eAn Admin is an administrator of an Account or a location with different access levels defined by \u003ccode\u003eAdminRole\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAdmins can have roles like Primary Owner, Owner, Manager, and Site Manager, each with varying permissions.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage Admins by inviting, removing, listing, and updating them using the provided methods.\u003c/p\u003e\n"],["\u003cp\u003eAdmin details include name, role, account association, and pending invitation status, represented in JSON format.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eAdminRole\u003c/code\u003e enum defines the access level of an admin, impacting their capabilities within the account or location.\u003c/p\u003e\n"]]],["Account and location administrators, identified by a resource name, have roles like `PRIMARY_OWNER`, `OWNER`, `MANAGER`, or `SITE_MANAGER`. Admins can be created by inviting a user via email, and roles are set during creation. The `pendingInvitation` field shows if an invite is pending. Available actions include: creating, deleting, listing, and updating admin access. `Admin` field contains the invitee's email address initially or user details after accepting.\n"],null,["# REST Resource: accounts.admins\n\n- [Resource: Admin](#Admin)\n - [JSON representation](#Admin.SCHEMA_REPRESENTATION)\n - [AdminRole](#Admin.AdminRole)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Admin\n---------------\n\nAn administrator of an Account or a location.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"admin\": string, \"account\": string, \"role\": enum (/my-business/reference/accountmanagement/rest/v1/accounts.admins#Admin.AdminRole), \"pendingInvitation\": boolean } ``` |\n\n| Fields ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Immutable. The resource name. For account admins, this is in the form: `accounts/{account_id}/admins/{admin_id}` For location admins, this is in the form: `locations/{locationId}/admins/{admin_id}` This field will be ignored if set during admin creation. |\n| `admin` | `string` Optional. The name of the admin. When making the initial invitation, this is the invitee's email address. On `GET` calls, the user's email address is returned if the invitation is still pending. Otherwise, it contains the user's first and last names. This field is only needed to be set during admin creation. |\n| `account` | `string` Immutable. The name of the Account resource that this Admin refers to. Used when calling locations.admins.create to invite a LocationGroup as an admin. If both this field and `admin` are set on `CREATE` requests, this field takes precedence and the email address in `admin` will be ignored. Format: `accounts/{account}`. |\n| `role` | `enum (`[AdminRole](/my-business/reference/accountmanagement/rest/v1/accounts.admins#Admin.AdminRole)`)` Required. Specifies the role that this admin uses with the specified Account or Location. |\n| `pendingInvitation` | `boolean` Output only. Indicates whether this admin has a pending invitation for the specified resource. |\n\n### AdminRole\n\nIndicates the access level that an admin has. For more information, see the [help center article](https://support.google.com/business/answer/3403100)\n\n| Enums ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `ADMIN_ROLE_UNSPECIFIED` | Not specified. |\n| `PRIMARY_OWNER` | The admin has owner-level access and is the primary owner. (Displays as 'Primary Owner' in UI). |\n| `OWNER` | The admin has owner-level access. (Displays as 'Owner' in UI). |\n| `MANAGER` | The admin has managerial access. |\n| `SITE_MANAGER` | The admin can manage social (Google+) pages. (Displays as 'Site Manager' in UI). This API doesn't allow creating an account admin with a SITE_MANAGER role. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------|----------------------------------------------------------------------------------|\n| ### [create](/my-business/reference/accountmanagement/rest/v1/accounts.admins/create) | Invites the specified user to become an administrator for the specified account. |\n| ### [delete](/my-business/reference/accountmanagement/rest/v1/accounts.admins/delete) | Removes the specified admin from the specified account. |\n| ### [list](/my-business/reference/accountmanagement/rest/v1/accounts.admins/list) | Lists the admins for the specified account. |\n| ### [patch](/my-business/reference/accountmanagement/rest/v1/accounts.admins/patch) | Updates the Admin for the specified Account Admin. |"]]
