La API de
Google Business Performance tiene un método de API
NUEVO que permite recuperar varias métricas "DailyMetrics" en una sola solicitud a la API.
Revise el
programa de baja y las instrucciones para migrar del método de la API de reportInsights versión 4 a la API de rendimiento del Perfil de Negocio de Google.
REST Resource: accounts.admins
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recurso: Administrador
El administrador de una cuenta o una ubicación.
| Representación JSON |
{
"name": string,
"admin": string,
"account": string,
"role": enum (AdminRole),
"pendingInvitation": boolean
} |
| Campos |
name |
string
Inmutable. Nombre del recurso. Para los administradores de cuenta, utiliza este formato: accounts/{account_id}/admins/{admin_id} Para los administradores de ubicación, utiliza este formato: locations/{locationId}/admins/{admin_id} Se ignorará este campo si se configura durante la creación del administrador.
|
admin |
string
Opcional. El nombre del administrador. Cuando se hace la invitación inicial, esta es la dirección de correo electrónico del invitado. En las llamadas a GET, se muestra la dirección de correo electrónico del usuario si la invitación aún está pendiente. De lo contrario, contiene el nombre y apellido del usuario. Este campo solo se debe configurar durante la creación del administrador.
|
account |
string
Inmutable. El nombre del recurso de cuenta al que hace referencia este administrador. Se usa cuando se llama a locations.admins.create para invitar a un LocationGroup como administrador. Si se configuran este campo y admin en solicitudes CREATE, este campo tiene prioridad y se ignorará la dirección de correo electrónico en admin. Formato: accounts/{account}.
|
role |
enum (AdminRole)
Obligatorio. Especifica el rol que utilizará este administrador con la cuenta o ubicación especificada.
|
pendingInvitation |
boolean
Solo salida. Indica si este administrador tiene una invitación pendiente para el recurso especificado.
|
AdminRole
| Enumeraciones |
ADMIN_ROLE_UNSPECIFIED |
No se especifica. |
PRIMARY_OWNER |
El administrador tiene acceso de nivel de propietario y es el propietario principal. (Se muestra como "Propietario principal" en la IU). |
OWNER |
El administrador tiene acceso de nivel de propietario. (Se muestra como "Propietario" en la IU). |
MANAGER |
El administrador tiene acceso de gerencia. |
SITE_MANAGER |
El administrador puede administrar las páginas sociales (Google+). (Se muestra como "Administrador del sitio" en la IU). Esta API no permite crear un administrador de cuenta con el rol SITE_MANAGER. |
Métodos |
|
|
Invita al usuario especificado a convertirse en administrador de la cuenta especificada. |
|
|
Quita al administrador especificado de la cuenta indicada. |
|
|
Muestra una lista de los administradores de la cuenta especificada. |
|
|
Actualiza el administrador del administrador de cuenta especificado. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\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. |"]]
