REST Resource: users

Recurso: User

Es un recurso de usuario.

Representación JSON
{
  "name": string,
  "email": string,
  "accessState": enum (AccessState),
  "expirationTime": string,
  "partial": boolean,
  "developerAccountPermissions": [
    enum (DeveloperLevelPermission)
  ],
  "grants": [
    {
      object (Grant)
    }
  ]
}
Campos
name

string

Obligatorio. Es el nombre del recurso para este usuario, que sigue el patrón "developers/{developer}/users/{email}".

email

string

Inmutable. La dirección de correo electrónico del usuario.

accessState

enum (AccessState)

Solo salida. Es el estado del acceso del usuario a Play Console.

expirationTime

string (Timestamp format)

Es la fecha y hora en la que vence el acceso del usuario, si se configuró. El valor que se defina siempre tiene que hacer referencia a un momento futuro.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

partial

boolean

Solo salida. Indica si hay más permisos para el usuario que no se representan aquí. Esto puede ocurrir si el llamador no tiene permiso para administrar todas las apps en la cuenta. También será true si el usuario es el propietario de la cuenta.

Si este campo es true, debe considerarse como un indicador de que este usuario no se puede administrar completamente a través de la API. Es decir, el emisor de la llamada a la API no puede administrar todos los permisos que tiene este usuario, ya sea porque no los conoce o porque el usuario es el propietario de la cuenta.

developerAccountPermissions[]

enum (DeveloperLevelPermission)

Son permisos de usuario que se aplican a toda la cuenta de desarrollador.

grants[]

object (Grant)

Solo salida. Son permisos por app para el usuario.

AccessState

Es el estado del acceso de un usuario a una cuenta de desarrollador.

Enums
ACCESS_STATE_UNSPECIFIED Indica que el estado de acceso es desconocido o que este no se especificó.
INVITED Indica que se invitó al usuario, pero este aún no aceptó la invitación.
INVITATION_EXPIRED Indica que venció la invitación.
ACCESS_GRANTED Indica que el usuario aceptó una invitación y tiene acceso a Play Console.
ACCESS_EXPIRED Indica que venció el acceso a la cuenta.

DeveloperLevelPermission

Es un permiso que se otorga a nivel de la cuenta de desarrollador.

Enums
DEVELOPER_LEVEL_PERMISSION_UNSPECIFIED Indica que es un permiso desconocido o que este no se especificó.
CAN_SEE_ALL_APPS

Permite ver información de la app y descargar informes masivos (solo lectura). Obsoleto: Consulta CAN_VIEW_NON_FINANCIAL_DATA_GLOBAL.

CAN_VIEW_FINANCIAL_DATA_GLOBAL Permite ver datos financieros, pedidos y respuestas a la encuesta de cancelación.
CAN_MANAGE_PERMISSIONS_GLOBAL Administrador (todos los permisos).
CAN_EDIT_GAMES_GLOBAL Permite editar proyectos de Servicios de juego de Play.
CAN_PUBLISH_GAMES_GLOBAL Permite publicar proyectos de Servicios de Play Games.
CAN_REPLY_TO_REVIEWS_GLOBAL Permite responder a opiniones.
CAN_MANAGE_PUBLIC_APKS_GLOBAL Permite lanzar la app a producción, excluir dispositivos y usar la firma de apps de Google Play.
CAN_MANAGE_TRACK_APKS_GLOBAL Permite lanzar la app a segmentos de pruebas.
CAN_MANAGE_TRACK_USERS_GLOBAL Permite administrar segmentos de pruebas y editar listas de verificadores.
CAN_MANAGE_PUBLIC_LISTING_GLOBAL Administrar la presencia en Play Store
CAN_MANAGE_DRAFT_APPS_GLOBAL Permite crear, editar y borrar apps en borrador.
CAN_CREATE_MANAGED_PLAY_APPS_GLOBAL Permite crear y publicar apps privadas para tu organización.
CAN_CHANGE_MANAGED_PLAY_SETTING_GLOBAL Permite elegir si las apps serán públicas o si solo estarán disponibles para la organización.
CAN_MANAGE_ORDERS_GLOBAL Administrar pedidos y suscripciones
CAN_MANAGE_APP_CONTENT_GLOBAL Permite administrar páginas relacionadas con políticas en todas las apps del desarrollador.
CAN_VIEW_NON_FINANCIAL_DATA_GLOBAL Permite ver información de la app y descargar informes masivos (solo lectura).
CAN_VIEW_APP_QUALITY_GLOBAL Permite ver información de la calidad de cualquier app del desarrollador.

Métodos

create

Otorga acceso a un usuario a la cuenta de desarrollador indicada.

delete

Quita el acceso del usuario a la cuenta de desarrollador especificada.

list

Enumera todos los usuarios con acceso a una cuenta de desarrollador.

patch

Actualiza el acceso del usuario a la cuenta de desarrollador.

Códigos de error

Las operaciones de este recurso devuelven los siguientes códigos de error HTTP:

Código de error Motivo Descripción Solución
400 invalidValue Se proporcionó un valor no válido en la solicitud. A menudo, se devuelve para un token de compra con formato incorrecto o no válido. Corrige el valor del campo no válido en el cuerpo o los parámetros de la solicitud según la referencia de la API.
400 required Falta un campo o parámetro obligatorio en la solicitud. Consulta la documentación de la API para asegurarte de que se incluyan todos los campos y parámetros obligatorios.
403 userInsufficientPermission El usuario no tiene permisos suficientes para realizar la operación solicitada. Asegúrate de que el usuario autenticado tenga los permisos necesarios en Google Play Console. Consulta Cómo usar una cuenta de servicio para obtener más detalles.
404 notFound No se encontró el recurso solicitado. Verifica que los identificadores (p.ej., token de compra, nombre del paquete, ID de producto, ID de suscripción) sean correctos.
409 concurrentUpdate Se intentó actualizar un objeto que se está actualizando de forma simultánea. Vuelve a intentarlo con una retirada exponencial. Evita las modificaciones simultáneas en el mismo recurso.
5xx Generic error Error genérico en el servidor de Google Play. Vuelve a intentar enviar tu solicitud.

Si el problema persiste, comunícate con tu administrador de cuentas de Google Play o envía una solicitud de asistencia. Considera consultar el Panel de estado de Play para ver si hay interrupciones conocidas.