Google Drive Parameters

Este documento lista os parâmetros para vários tipos de eventos de atividade do Google Drive. É possível recuperar esses eventos chamando UserUsageReport.get() com parameters=drive:PARAMETER.

Essas métricas refletem o comportamento agregado dos usuários nos itens do Google Drive no seu domínio.

Os dados de relatórios podem ser divididos em números do ponto de vista de um ator ou proprietário.
  • Métricas do ator: a pessoa que realiza a ação em um arquivo.
  • Métricas do proprietário: a pessoa que é proprietária do arquivo em que a ação está sendo realizada. Os valores com owned nos nomes se referem aos dados do proprietário.

Parâmetros de visibilidade

Os parâmetros podem fornecer métricas de visibilidade e propriedade agregadas para itens no seu domínio. Esses parâmetros se enquadram em três formas gerais, em que "*" é substituído por qualquer um dos campos listados na tabela Níveis de visibilidade abaixo:

num_owned_items_with_visibility_*_added
esses itens do Drive ou dos Documentos com pelo menos um evento do tipo addition realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade aparece no relatório com qualquer estado final do item. Vários eventos addition no mesmo arquivo não aumentam a contagem.
num_owned_items_with_visibility_*_removed
esses itens do Drive ou dos Documentos com pelo menos um evento do tipo removal realizado neles, como lixeira, exclusão permanente ou transferência de propriedade. Essa atividade aparece no relatório com qualquer estado final do item.
num_owned_items_with_visibility_*_delta
a mudança líquida no número de itens do Google Docs e do Drive que pertencem a todo o domínio, segmentado por usuário. Por exemplo, se um item for adicionado e outro removido, as métricas adicionadas e removidas vão informar 1, mas a métrica delta vai informar 0.

Para os totais de eventos, apenas um evento addition ou removal por item é contabilizado para o valor final. Por exemplo, se um arquivo for adicionado ao Drive e transferido para outro proprietário, isso vai acionar dois eventos addition e um evento removal, mas a contagem final para esse arquivo será uma adição e uma remoção.

Definições de visibilidade

A tabela a seguir lista os campos em ordem de visibilidade, da menor (privada) à maior (pública).

Tabela: níveis de visibilidade
Campo Definição
privado O arquivo não é compartilhado com ninguém.
shared_internally O arquivo é compartilhado apenas com usuários/grupos no domínio do proprietário.
anyone_in_domain_with_link O arquivo é compartilhado para que qualquer pessoa no domínio com o link possa acessá-lo.
anyone_in_domain O arquivo é compartilhado para que qualquer pessoa no domínio possa encontrá-lo e acessá-lo.
shared_externally O arquivo é compartilhado para que usuários/grupos externos ao domínio do proprietário possam acessá-lo.
anyone_with_link O arquivo é compartilhado para que qualquer pessoa com o link possa acessá-lo.
público O arquivo é acessível publicamente.

Métricas em vários níveis de visibilidade ou eventos

O cálculo das métricas de visibilidade considera apenas o estado de visibilidade mais alto ou mais público de um determinado arquivo. Por exemplo, considere as seguintes configurações de compartilhamento aplicadas a um único arquivo. Embora o arquivo tenha vários estados de visibilidade, apenas o estado de visibilidade public é informado.

Exemplo de estado de visibilidade
Configuração de compartilhamento Estado de visibilidade
Visível publicamente public
Compartilhado com alguns usuários no domínio shared_internally
Compartilhado com usuários específicos fora do domínio shared_externally

Parâmetros de atividade do item

Os parâmetros de atividade do item podem fornecer métricas de atividade para itens no seu domínio.

Nome Tipo Descrição
num_google_documents_created número inteiro O número de documentos do Google criados pelo usuário ou domínio. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_google_documents_edited número inteiro O número de documentos do Google editados pelo usuário ou domínio. Várias edições do mesmo arquivo são contadas apenas uma vez por arquivo.
num_google_documents_trashed número inteiro O número de documentos do Google que foram excluídos pelo usuário ou domínio. Se um item for excluído e depois restaurado, ele ainda será contado na métrica. Se um item for excluído várias vezes, ele será contado apenas uma vez na métrica.
num_google_documents_viewed número inteiro O número de documentos do Google que o usuário ou domínio visualizou. Várias visualizações do mesmo arquivo são contadas apenas uma vez por arquivo.
num_google_drawings_created número inteiro O número de desenhos do Google criados pelo usuário ou domínio. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_google_drawings_edited número inteiro O número de desenhos do Google editados pelo usuário ou domínio. Várias edições do mesmo arquivo são contadas apenas uma vez por arquivo.
num_google_drawings_trashed número inteiro O número de itens do Google Desenhos excluídos pelo usuário ou domínio. Se um item for excluído e depois restaurado, ele ainda será contado na métrica. Se um item for excluído várias vezes, ele será contado apenas uma vez na métrica.
num_google_drawings_viewed número inteiro O número de documentos do Google Desenhos visualizados pelo usuário ou domínio. Várias visualizações do mesmo arquivo são contadas apenas uma vez por arquivo.
num_google_forms_created número inteiro O número de Formulários Google criados pelo usuário ou domínio. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_google_forms_edited número inteiro O número de Formulários Google editados pelo usuário ou domínio. Várias edições do mesmo arquivo são contadas apenas uma vez por arquivo.
num_google_forms_trashed número inteiro O número de Formulários Google excluídos pelo usuário ou domínio. Se um item for excluído e depois restaurado, ele ainda será contado na métrica. Se um item for excluído várias vezes, ele será contado apenas uma vez na métrica.
num_google_forms_viewed número inteiro O número de Formulários Google acessados pelo usuário ou domínio. Várias visualizações do mesmo arquivo são contadas apenas uma vez por arquivo.
num_google_presentations_created número inteiro O número de Apresentações Google criadas pelo usuário ou domínio. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_google_presentations_edited número inteiro O número de Apresentações Google editadas pelo usuário ou domínio. Várias edições do mesmo arquivo são contadas apenas uma vez por arquivo.
num_google_presentations_trashed número inteiro O número de apresentações do Google Apresentações excluídas pelo usuário ou domínio. Se um item for excluído e depois restaurado, ele ainda será contado na métrica. Se um item for excluído várias vezes, ele será contado apenas uma vez na métrica.
num_google_presentations_viewed número inteiro O número de apresentações do Google exibidas pelo usuário ou domínio. Várias visualizações do mesmo arquivo são contadas apenas uma vez.
num_google_sites_created número inteiro O número de sites do Google criados pelo usuário ou domínio. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_google_sites_edited número inteiro O número de sites do Google editados pelo usuário ou domínio. Várias edições do mesmo arquivo são contadas apenas uma vez por arquivo.
num_google_sites_trashed número inteiro O número de sites do Google que foram excluídos pelo usuário ou domínio. Se um item for excluído e depois restaurado, ele ainda será contado na métrica. Se um item for excluído várias vezes, ele será contado apenas uma vez na métrica.
num_google_sites_viewed número inteiro O número de sites do Google acessados pelo usuário ou domínio. Várias visualizações do mesmo arquivo são contadas apenas uma vez por arquivo.
num_google_spreadsheets_created número inteiro O número de planilhas do Google criadas pelo usuário ou domínio. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_google_spreadsheets_edited número inteiro O número de planilhas do Google editadas pelo usuário ou domínio. Várias edições do mesmo arquivo são contadas apenas uma vez por arquivo.
num_google_spreadsheets_trashed número inteiro O número de planilhas do Google que foram enviadas para a lixeira pelo usuário ou domínio. Se um item for excluído e depois restaurado, ele ainda será contado na métrica. Se um item for excluído várias vezes, ele será contado apenas uma vez na métrica.
num_google_spreadsheets_viewed número inteiro O número de planilhas do Google que o usuário ou domínio visualizou. Várias visualizações do mesmo arquivo são contadas apenas uma vez por arquivo.
num_items_created número inteiro O número de itens do Google Drive criados pelo usuário ou domínio. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_items_edited número inteiro O número de itens do Google Drive editados pelo usuário ou domínio. Várias edições do mesmo arquivo são contadas apenas uma vez por arquivo.
num_items_trashed número inteiro O número de itens do Google Drive excluídos pelo usuário ou domínio. Se um item for excluído e depois restaurado, ele ainda será contado na métrica. Se um item for excluído várias vezes, ele será contado apenas uma vez na métrica.
num_items_viewed número inteiro O número de itens do Google Drive visualizados pelo usuário ou domínio. Várias visualizações do mesmo arquivo são contadas apenas uma vez por arquivo.
num_other_types_created número inteiro O número de outros itens do Google Drive criados pelo usuário ou domínio. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_other_types_edited número inteiro O número de outros itens do Google Drive editados pelo usuário ou domínio. Várias edições do mesmo arquivo são contadas apenas uma vez por arquivo.
num_other_types_trashed número inteiro O número de outros itens do Google Drive excluídos pelo usuário ou domínio. Se um item for excluído e depois restaurado, ele ainda será contado na métrica. Se um item for excluído várias vezes, ele será contado apenas uma vez na métrica.
num_other_types_viewed número inteiro O número de outros itens do Google Drive visualizados pelo usuário ou domínio. Várias visualizações do mesmo arquivo são contadas apenas uma vez por arquivo.
num_owned_external_items_added número inteiro O número de itens externos do Google Drive adicionados à organização.
num_owned_external_items_delta número inteiro
num_owned_external_items_removed número inteiro
num_owned_google_documents_added número inteiro O número de documentos do Google com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_google_documents_created número inteiro O número de documentos do Google criados no dia do relatório em que o usuário do domínio é o proprietário. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_owned_google_documents_delta número inteiro O número de documentos do Google Docs na conta do cliente em que a propriedade mudou, para aumentar ou diminuir a propriedade do arquivo.
num_owned_google_documents_edited número inteiro O número de Documentos Google na conta do cliente que foram editados.
num_owned_google_documents_removed número inteiro O número de documentos do Google na conta do cliente que foram removidos.
num_owned_google_documents_trashed número inteiro O número de documentos do Google na conta do cliente que foram excluídos.
num_owned_google_documents_viewed número inteiro O número de documentos do Google na conta do cliente que foram visualizados.
num_owned_google_drawings_added número inteiro O número de desenhos do Google com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_google_drawings_created número inteiro O número de desenhos do Google criados no dia em que o relatório foi gerado e em que o usuário é o proprietário do domínio. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_owned_google_drawings_delta número inteiro O número de desenhos do Google na conta do cliente em que a propriedade mudou, para aumentar ou diminuir a propriedade do arquivo.
num_owned_google_drawings_edited número inteiro O número de Documentos Google na conta do cliente que foram editados.
num_owned_google_drawings_removed número inteiro O número de desenhos do Google na conta do cliente que foram removidos.
num_owned_google_drawings_trashed número inteiro O número de desenhos do Google na conta do cliente que foram excluídos.
num_owned_google_drawings_viewed número inteiro Número de desenhos do Google na conta do cliente que foram visualizados.
num_owned_google_forms_added número inteiro O número de formulários do Google com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_google_forms_created número inteiro O número de Formulários Google criados no dia em que o relatório foi gerado e em que o usuário do domínio é o proprietário. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_owned_google_forms_delta número inteiro O número de Formulários Google na conta do cliente em que a propriedade mudou, aumentando ou diminuindo a propriedade do arquivo.
num_owned_google_forms_edited número inteiro O número de Documentos Google na conta do cliente que foram editados.
num_owned_google_forms_removed número inteiro O número de Formulários Google na conta do cliente que foram removidos.
num_owned_google_forms_trashed número inteiro O número de Formulários Google na conta do cliente que foram excluídos.
num_owned_google_forms_viewed número inteiro O número de Formulários Google na conta do cliente que foram visualizados.
num_owned_google_presentations_added número inteiro O número de apresentações do Google com pelo menos um evento do tipo "adição" realizado nelas, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_google_presentations_created número inteiro O número de Apresentações Google criadas no dia do relatório em que o usuário do domínio é o proprietário. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_owned_google_presentations_delta número inteiro O número de apresentações do Google na conta do cliente em que a propriedade mudou, aumentando ou diminuindo a propriedade do arquivo.
num_owned_google_presentations_edited número inteiro O número de apresentações do Google na conta do cliente que foram editadas.
num_owned_google_presentations_removed número inteiro O número de apresentações do Google na conta do cliente que foram removidas.
num_owned_google_presentations_trashed número inteiro O número de apresentações do Google na conta do cliente que foram enviadas para a lixeira.
num_owned_google_presentations_viewed número inteiro O número de apresentações do Google na conta do cliente que foram visualizadas.
num_owned_google_sites_added número inteiro O número de sites do Google com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_google_sites_created número inteiro O número de sites do Google criados no dia do relatório em que o usuário do domínio é o proprietário. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_owned_google_sites_delta número inteiro O número de sites do Google Sites na conta do cliente em que a propriedade mudou, para aumentar ou diminuir a propriedade do arquivo.
num_owned_google_sites_edited número inteiro O número de sites do Google Sites na conta do cliente que foram editados.
num_owned_google_sites_removed número inteiro O número de sites do Google na conta do cliente que foram removidos.
num_owned_google_sites_trashed número inteiro O número de sites do Google na conta do cliente que foram excluídos.
num_owned_google_sites_viewed número inteiro O número de sites do Google na conta do cliente que foram visualizados.
num_owned_google_spreadsheets_added número inteiro O número de planilhas do Google com pelo menos um evento do tipo "adição" realizado nelas, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_google_spreadsheets_created número inteiro O número de planilhas do Google criadas no dia em que o relatório foi gerado e em que o usuário é o proprietário do domínio. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_owned_google_spreadsheets_delta número inteiro O número de planilhas do Google na conta do cliente em que a propriedade mudou, aumentando ou diminuindo a propriedade do arquivo.
num_owned_google_spreadsheets_edited número inteiro O número de planilhas do Google na conta do cliente que foram editadas.
num_owned_google_spreadsheets_removed número inteiro O número de planilhas do Google na conta do cliente que foram removidas.
num_owned_google_spreadsheets_trashed número inteiro O número de planilhas do Google na conta do cliente que foram excluídas.
num_owned_google_spreadsheets_viewed número inteiro Número de planilhas do Google na conta do cliente que foram visualizadas.
num_owned_internal_items_added número inteiro O número de itens internos do Google Drive com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_internal_items_delta número inteiro
num_owned_internal_items_removed número inteiro
num_owned_items_added número inteiro O número de itens do Google Drive com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_items_created número inteiro O número de itens do Google Drive criados no dia do relatório em que o usuário do domínio é o proprietário. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_owned_items_delta número inteiro O número de itens do Google Drive na conta do cliente em que a propriedade mudou, para aumentar ou diminuir a propriedade do arquivo.
num_owned_items_edited número inteiro O número de itens do Google Drive na conta do cliente que foram editados.
num_owned_items_removed número inteiro O número de itens do Google Drive na conta do cliente que foram removidos.
num_owned_items_trashed número inteiro O número de itens do Google Drive na conta do cliente que foram excluídos.
num_owned_items_viewed número inteiro Número de itens do Google Drive na conta do cliente que foram acessados.
num_owned_items_with_visibility_anyone_in_domain_added número inteiro O número de itens do Google Drive configurados com uma visibilidade de anyone_in_domain com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_items_with_visibility_anyone_in_domain_delta número inteiro O número de itens do Google Drive configurados com uma visibilidade de anyone_in_domain na conta do cliente em que a propriedade mudou, para aumentar ou diminuir a propriedade do arquivo.
num_owned_items_with_visibility_anyone_in_domain_removed número inteiro O número de itens do Google Drive configurados com uma visibilidade de anyone_in_domain na conta do cliente que foram removidos.
num_owned_items_with_visibility_anyone_in_domain_with_link_added número inteiro O número de itens do Google Drive configurados com uma visibilidade de anyone_in_domain_with_link com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_items_with_visibility_anyone_in_domain_with_link_delta número inteiro O número de itens do Google Drive configurados com uma visibilidade de anyone_in_domain_with_link na conta do cliente em que a propriedade mudou, para aumentar ou diminuir a propriedade do arquivo.
num_owned_items_with_visibility_anyone_in_domain_with_link_removed número inteiro O número de itens do Google Drive configurados com uma visibilidade de anyone_in_domain_with_link na conta do cliente que foram removidos.
num_owned_items_with_visibility_anyone_with_link_added número inteiro O número de itens do Google Drive configurados com uma visibilidade de anyone_with_link com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_items_with_visibility_anyone_with_link_delta número inteiro O número de itens do Google Drive configurados com uma visibilidade de anyone_with_link na conta do cliente em que a propriedade mudou, para aumentar ou diminuir a propriedade do arquivo.
num_owned_items_with_visibility_anyone_with_link_removed número inteiro O número de itens do Google Drive configurados com uma visibilidade de anyone_with_link na conta do cliente que foram removidos.
num_owned_items_with_visibility_private_added número inteiro O número de itens do Google Drive configurados com uma visibilidade de private com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_items_with_visibility_private_delta número inteiro O número de itens do Google Drive configurados com uma visibilidade de private na conta do cliente em que a propriedade mudou, para aumentar ou diminuir a propriedade do arquivo.
num_owned_items_with_visibility_private_removed número inteiro O número de itens do Google Drive configurados com uma visibilidade de private na conta do cliente que foram removidos.
num_owned_items_with_visibility_public_added número inteiro O número de itens do Google Drive configurados com uma visibilidade de public com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_items_with_visibility_public_delta número inteiro O número de itens do Google Drive configurados com uma visibilidade de public na conta do cliente em que a propriedade mudou, para aumentar ou diminuir a propriedade do arquivo.
num_owned_items_with_visibility_public_removed número inteiro O número de itens do Google Drive configurados com uma visibilidade de public na conta do cliente que foram removidos.
num_owned_items_with_visibility_shared_externally_added número inteiro O número de itens do Google Drive configurados com uma visibilidade de shared_externally com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_items_with_visibility_shared_externally_delta número inteiro O número de itens do Google Drive configurados com uma visibilidade de shared_externally na conta do cliente em que a propriedade mudou, para aumentar ou diminuir a propriedade do arquivo.
num_owned_items_with_visibility_shared_externally_removed número inteiro O número de itens do Google Drive configurados com uma visibilidade de shared_externally na conta do cliente que foram removidos.
num_owned_items_with_visibility_shared_internally_added número inteiro O número de itens do Google Drive configurados com uma visibilidade de shared_internally com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_items_with_visibility_shared_internally_delta número inteiro O número de itens do Google Drive configurados com uma visibilidade de shared_internally na conta do cliente em que a propriedade mudou, para aumentar ou diminuir a propriedade do arquivo.
num_owned_items_with_visibility_shared_internally_removed número inteiro O número de itens do Google Drive configurados com uma visibilidade de shared_internally na conta do cliente que foram removidos.
num_owned_items_with_visibility_unknown_added número inteiro
num_owned_items_with_visibility_unknown_delta número inteiro
num_owned_items_with_visibility_unknown_removed número inteiro
num_owned_other_types_added número inteiro O número de outros itens do Google Drive com pelo menos um evento do tipo "adição" realizado neles, como criação, uploads, eventos de retirada da lixeira ou transferência de propriedade. Essa atividade é informada independentemente do estado final do item.
num_owned_other_types_created número inteiro O número de outros itens do Google Drive criados pelo usuário ou domínio. Isso não rastreia itens que entraram na posse do cliente por meio de restauração, restauração de exclusão ou transferência de propriedade.
num_owned_other_types_delta número inteiro O número de outros itens do Google Drive na conta do cliente em que a propriedade mudou, para aumentar ou diminuir a propriedade do arquivo.
num_owned_other_types_edited número inteiro O número de outros itens do Google Drive editados pelo usuário ou domínio. Várias edições do mesmo arquivo são contadas apenas uma vez por arquivo.
num_owned_other_types_removed número inteiro O número de outros itens do Google Drive na conta do cliente que foram removidos.
num_owned_other_types_trashed número inteiro O número de outros itens do Google Drive na conta do cliente que foram excluídos.
num_owned_other_types_viewed número inteiro Número de outros itens do Google Drive na conta do cliente que foram visualizados.
timestamp_last_active_usage número inteiro Indica a última vez que o usuário usou o Google Drive.