REST Resource: folders.approvalRequests

Recurso: ApprovalRequest

Es una solicitud para que el cliente apruebe el acceso a un recurso.

Representación JSON
{
  "name": string,
  "requestedResourceName": string,
  "requestedResourceProperties": {
    object (ResourceProperties)
  },
  "requestedReason": {
    object (AccessReason)
  },
  "requestedLocations": {
    object (AccessLocations)
  },
  "requestTime": string,
  "requestedExpiration": string,

  // Union field decision can be only one of the following:
  "approve": {
    object (ApproveDecision)
  },
  "dismiss": {
    object (DismissDecision)
  }
  // End of list of possible types for union field decision.
}
Campos
name

string

Es el nombre del recurso de la solicitud. El formato es "{projects|folders|organizations}/{id}/approvalRequests/{approval_request}".

requestedResourceName

string

El recurso para el que se solicita aprobación. El formato del nombre del recurso se define en https://cloud.google.com/apis/design/resource_names. Aquí, el nombre del recurso puede ser un nombre de recurso "completo" (p.ej., "//library.googleapis.com/keystore/shelf1/books/book2") o un nombre de recurso "relativo" (p.ej., " Python/shelf1/books/book2") como se describe en la especificación del nombre del recurso.

requestedResourceProperties

object (ResourceProperties)

Propiedades relacionadas con el recurso representado por requestResourceName.

requestedReason

object (AccessReason)

Es la justificación para la que se solicita la aprobación.

requestedLocations

object (AccessLocations)

Son las ubicaciones para las que se solicita la aprobación.

requestTime

string (Timestamp format)

La hora en la que se solicitó la aprobación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

requestedExpiration

string (Timestamp format)

Es el vencimiento solicitado para la aprobación. Si se aprueba la solicitud, el acceso se otorgará desde el momento de la aprobación hasta la fecha de vencimiento.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

Campo de unión decision. La decisión actual sobre la solicitud de aprobación. decision puede ser solo uno de los siguientes:
approve

object (ApproveDecision)

Se aprobó el acceso.

dismiss

object (DismissDecision)

Se descartó la solicitud.

ResourceProperties

Las propiedades asociadas con el recurso de la solicitud.

Representación JSON
{
  "excludesDescendants": boolean
}
Campos
excludesDescendants

boolean

Indica si una aprobación excluirá los descendientes del recurso que se solicita.

AccessReason

Representación JSON
{
  "type": enum (Type),
  "detail": string
}
Campos
type

enum (Type)

Tipo de justificación del acceso.

detail

string

Más detalles sobre ciertos tipos de motivos. Consulta los comentarios para cada tipo anterior.

Tipo

Tipo de justificación del acceso.

Enums
TYPE_UNSPECIFIED No se debe usar el valor predeterminado para proto.
CUSTOMER_INITIATED_SUPPORT

El cliente hizo una solicitud o informó un problema que requería que la principal accediera a los datos del cliente. detail tiene el formato ("#####" es el ID del problema):

  • "Informe de comentarios: #####"
  • “Número de caso: #####”
  • “ID del caso: #####”
  • "Referencia del PIN E: #####"
  • “Google-#####”
  • “T-#####”
GOOGLE_INITIATED_SERVICE La principal accedió a los datos del cliente para diagnosticar o resolver un posible problema en los servicios. Este acceso suele usarse para confirmar que los clientes no se ven afectados por un presunto problema de servicio o para solucionar un problema reversible del sistema.
GOOGLE_INITIATED_REVIEW Google inició un servicio con fines de seguridad, fraude, abuso o cumplimiento.
THIRD_PARTY_DATA_REQUEST El principal se vio obligado a acceder a los datos de los clientes para responder a una solicitud o el procesamiento de datos de un tercero, incluidos los procesos legales de los propios clientes.
GOOGLE_RESPONSE_TO_PRODUCTION_ALERT La principal accedió a los datos del cliente para diagnosticar o resolver un posible problema en los servicios o una interrupción conocida.

AccessLocations

Oficina en casa y ubicación física del director.

Representación JSON
{
  "principalOfficeCountry": string,
  "principalPhysicalLocationCountry": string
}
Campos
principalOfficeCountry

string

La ubicación de la “oficina en casa” del director. Un código de país de dos letras (ISO 3166-1 alpha-2), como “US”, “DE”, “GB”, o un código de región. En algunas situaciones limitadas, los sistemas de Google pueden hacer referencia a un código de región en lugar de un código de país. Posibles códigos de región:

  • ASI: Asia
  • EUR: Europa
  • OCE: Oceanía
  • AFR: África
  • NAM: Norteamérica
  • SAM: Sudamérica
  • ANT: Antártida
  • CUALQUIERA: Cualquier ubicación
principalPhysicalLocationCountry

string

Ubicación física de la principal al momento del acceso. Un código de país de dos letras (ISO 3166-1 alpha-2), como “US”, “DE”, “GB”, o un código de región. En algunas situaciones limitadas, los sistemas de Google pueden hacer referencia a un código de región en lugar de un código de país. Posibles códigos de región:

  • ASI: Asia
  • EUR: Europa
  • OCE: Oceanía
  • AFR: África
  • NAM: Norteamérica
  • SAM: Sudamérica
  • ANT: Antártida
  • CUALQUIERA: Cualquier ubicación

ApproveDecision

Una decisión tomada para aprobar el acceso a un recurso.

Representación JSON
{
  "approveTime": string,
  "expireTime": string,
  "invalidateTime": string,
  "signatureInfo": {
    object (SignatureInfo)
  },
  "autoApproved": boolean
}
Campos
approveTime

string (Timestamp format)

La hora en la que se otorgó la aprobación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

expireTime

string (Timestamp format)

La hora en la que vence la aprobación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

invalidateTime

string (Timestamp format)

Si se establece, denota la marca de tiempo en la que se invalida la aprobación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

signatureInfo

object (SignatureInfo)

La firma de la solicitud de aprobación y los detalles de cómo se firmó.

autoApproved

boolean

Es verdadero cuando la solicitud se aprobó automáticamente.

SignatureInfo

Información sobre la firma digital del recurso.

Representación JSON
{
  "signature": string,

  // Union field verification_info can be only one of the following:
  "googlePublicKeyPem": string,
  "customerKmsKeyVersion": string
  // End of list of possible types for union field verification_info.
}
Campos
signature

string (bytes format)

La firma digital.

String codificada en base64.

Campo de unión verification_info. Cómo se puede verificar esta firma. verification_info puede ser solo uno de los siguientes:
googlePublicKeyPem

string

La clave pública para la firma predeterminada de Google, codificada en formato PEM. La firma se creó con una clave privada que puede verificarse con esta clave pública.

customerKmsKeyVersion

string

El nombre del recurso de la versión de CryptoKeyVersion del cliente que se usó para firmar.

DismissDecision

Una decisión que se tomó para descartar una solicitud de aprobación.

Representación JSON
{
  "dismissTime": string,
  "implicit": boolean
}
Campos
dismissTime

string (Timestamp format)

La hora en la que se descartó la solicitud de aprobación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

implicit

boolean

Este campo será verdadero si la solicitud de aprobación se descartó de forma implícita debido a la falta de acción de los responsables de aprobación de acceso (los responsables de aprobación no responden a la solicitud antes de la fecha de vencimiento).

Métodos

approve

Aprueba una solicitud y muestra la ApprovalRequest actualizada.

dismiss

Descarta una solicitud.

get

Obtiene una solicitud de aprobación.

invalidate

Invalida una ApprovalRequest existente.

list

Enumera las solicitudes de aprobación asociadas con un proyecto, una carpeta o una organización.