REST Resource: folders.approvalRequests

Recurso: ApprovalRequest

Uma solicitação para o cliente aprovar o acesso a um recurso.

Representação 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

O nome do recurso da solicitação. O formato é "{projects|folders|organizations}/{id}/approvalRequests/{approval_request}".
requestedResourceName

string

O recurso para o qual a aprovação está sendo solicitada. O formato do nome do recurso é definido em https://cloud.google.com/apis/design/resource_names. O nome do recurso pode ser um nome "completo" (por exemplo, "//library.googleapis.com/Categories/facilmente1/books/book2") ou um nome de recurso "relativo" (por exemplo, " completo/esse/books/book2"), conforme descrito na especificação do nome do recurso.
requestedResourceProperties

object (ResourceProperties)

Propriedades relacionadas ao recurso representado por requestedResourceName.
requestedReason

object (AccessReason)

A justificativa para a solicitação da aprovação.
requestedLocations

object (AccessLocations)

Os locais para os quais a aprovação está sendo solicitada.
requestTime

string (Timestamp format)

A hora em que a aprovação foi solicitada.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
requestedExpiration

string (Timestamp format)

A expiração solicitada para a aprovação. Se a solicitação for aprovada, o acesso será concedido a partir do momento da aprovação até o prazo de validade.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
Campo de união decision. A decisão atual sobre a solicitação de aprovação. decision só pode ser de um dos seguintes tipos:
approve

object (ApproveDecision)

O acesso foi aprovado.
dismiss

object (DismissDecision)

A solicitação foi dispensada.

ResourceProperties

As propriedades associadas ao recurso da solicitação.

Representação JSON 
{
  "excludesDescendants": boolean
}
Campos
excludesDescendants

boolean

Indica se uma aprovação excluirá os descendentes do recurso que está sendo solicitado.

AccessReason

Representação JSON 
{
  "type": enum (Type),
  "detail": string
}
Campos
type

enum (Type)

Tipo de justificativa de acesso.
detail

string

Mais detalhes sobre determinados tipos de motivo. Veja os comentários de cada tipo acima.

Tipo

Tipo de justificativa de acesso.

Tipos enumerados
TYPE_UNSPECIFIED O valor padrão do proto não deve ser usado.
CUSTOMER_INITIATED_SUPPORT

O cliente fez uma solicitação ou informou um problema que exigia o acesso do principal aos dados do cliente. detail está no formato ("#####" é o ID do problema):

  • "Relatório de feedback: #####"
  • "Número do caso: #####"
  • "Código do caso: #####"
  • "Referência do PIN: #####"
  • "Google-#####"
  • "T-#####"
GOOGLE_INITIATED_SERVICE O principal acessou os dados do cliente para diagnosticar ou resolver um problema suspeito nos serviços. Esse acesso geralmente é usado para confirmar que os clientes não foram afetados por um possível problema no serviço ou corrigir um problema reversível no sistema.
GOOGLE_INITIATED_REVIEW Serviço iniciado pelo Google para fins de segurança, fraude, abuso ou compliance.
THIRD_PARTY_DATA_REQUEST O principal foi obrigado a acessar os dados do cliente para responder a uma solicitação ou um processo legal de dados de terceiros, incluindo processos judiciais dos próprios clientes.
GOOGLE_RESPONSE_TO_PRODUCTION_ALERT O principal acessou os dados do cliente para diagnosticar ou resolver uma suspeita de problema nos serviços ou uma falha temporária conhecida.

AccessLocations

Escritório residencial e local físico do diretor.

Representação JSON 
{
  "principalOfficeCountry": string,
  "principalPhysicalLocationCountry": string
}
Campos
principalOfficeCountry

string

A localização do "escritório de casa" do diretor. Um código de país de duas letras (ISO 3166-1 alfa-2), como "US", "DE" ou "GB" ou um código de região. Em algumas situações limitadas, os sistemas do Google podem se referir ao código da região em vez do código do país. Possíveis códigos de região:

  • ASI: Ásia
  • EUR: Europa
  • OCE: Oceania
  • AFR: África
  • NAM: América do Norte
  • SAM: América do Sul
  • ANT: Antártida
  • QUALQUER: qualquer local
principalPhysicalLocationCountry

string

Localização física do principal no momento do acesso. Um código de país de duas letras (ISO 3166-1 alfa-2), como "US", "DE" ou "GB" ou um código de região. Em algumas situações limitadas, os sistemas do Google podem se referir ao código da região em vez do código do país. Possíveis códigos de região:

  • ASI: Ásia
  • EUR: Europa
  • OCE: Oceania
  • AFR: África
  • NAM: América do Norte
  • SAM: América do Sul
  • ANT: Antártida
  • QUALQUER: qualquer local

ApproveDecision

Uma decisão tomada para aprovar o acesso a um recurso.

Representação JSON 
{
  "approveTime": string,
  "expireTime": string,
  "invalidateTime": string,
  "signatureInfo": {
    object (SignatureInfo)
  },
  "autoApproved": boolean
}
Campos
approveTime

string (Timestamp format)

A hora em que a aprovação foi concedida.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
expireTime

string (Timestamp format)

A hora em que a aprovação expira.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
invalidateTime

string (Timestamp format)

Se definido, denota o carimbo de data/hora em que a aprovação é invalidada.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
signatureInfo

object (SignatureInfo)

A assinatura da ApprovalRequest e os detalhes sobre como ela foi assinada.
autoApproved

boolean

Verdadeiro quando a solicitação foi aprovada automaticamente.

SignatureInfo

Informações sobre a assinatura digital do recurso.

Representação 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)

A assinatura digital.

Uma string codificada em base64.
Campo de união verification_info. Como essa assinatura pode ser verificada. verification_info só pode ser de um dos seguintes tipos:
googlePublicKeyPem

string

A chave pública da assinatura padrão do Google, codificada no formato PEM. A assinatura foi criada com uma chave privada que pode ser verificada com esta chave pública.
customerKmsKeyVersion

string

O nome do recurso da versão da CryptoKey do cliente usada para assinatura.

DismissDecision

Uma decisão de dispensar uma solicitação de aprovação.

Representação JSON 
{
  "dismissTime": string,
  "implicit": boolean
}
Campos
dismissTime

string (Timestamp format)

A hora em que a solicitação de aprovação foi dispensada.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
implicit

boolean

Este campo será verdadeiro se a ApprovalRequest foi implicitamente dispensada devido à inação dos aprovadores de aprovação de acesso (a solicitação não é processada pelos aprovadores antes do tempo de exida).

Métodos

approve

 Aprova uma solicitação e retorna a ApprovalRequest atualizada.

dismiss

 Dispensa uma solicitação.

get

 Recebe uma solicitação de aprovação.

invalidate

 Invalida um ApprovalRequest existente.

list

 Lista as solicitações de aprovação associadas a um projeto, uma pasta ou uma organização.