Esta página foi traduzida pela API Cloud Translation.

Como criar interfaces do Google Drive

Os complementos do Google Workspace oferecem recursos interfaces quando o usuário está usando o Google Drive. Isso permite que você forneça ao usuário informações relevantes adicionais, automatizar tarefas e conectar para o Google Drive.

Como acessar a interface do complemento

É possível abrir um complemento do Google Workspace no Google Drive se o ícone dele aparecer na coluna de ícones do lado direito da interface do usuário do Drive. Um O complemento do Google Workspace definir uma interface de página inicial, uma interface de seleção de item ou ambas:

Se um usuário clicar no ícone do complemento no Google Drive, o complemento vai executar a função drive.homepageTrigger correspondente (se presente). Essa função cria e retorna um card da página inicial ao Google Drive para exibição. Se nenhuma função drive.homepageTrigger for definida, um card genérico da página inicial será mostrado.
Se o usuário selecionar um ou mais itens no Google Drive e clicar no complemento ou selecionar itens enquanto o complemento está aberto, ele executará a drive.onItemsSelectedTrigger função contextual (se houver). Essa função cria a interface contextual "itens selecionados" do Google Drive do complemento e a retorna para exibição.

Criar a interface de complementos do Drive

Para criar interfaces que estendem o Google Drive, siga estas etapas gerais:

Decida se você quer que o complemento tenha uma versão específica do Drive página inicial. Também decida se você quer fornecer uma interface contextual para quando o usuário selecionar itens do Drive.
Adicione os campos addOns.common e addOns.drive apropriados ao manifesto do projeto de script complementar, incluindo todos os escopos do Drive necessários.
Se você fornecer uma página inicial específica do Drive, implementar drive.homepageTrigger para criar essa interface. Você também pode usar a interface common.homepageTrigger para vários hosts do Google Workspace.
Se você estiver fornecendo uma interface de seleção de itens contextuais do Drive, será necessário implementar uma função de gatilho contextual drive.onItemsSelectedTrigger para criar essa interface. Consulte Interface contextual do Drive para itens selecionados para mais detalhes.
Implemente as funções de callback associadas necessárias para responder às interações da interface do usuário, como cliques em botões.

Páginas iniciais do Drive

O Google Drive oferece suporte para mostrar as páginas iniciais dos complementos do Google Workspace. Para mostrar a página inicial comum do complemento no Google Drive, basta verificar se há um campo addOns.drive no manifesto do complemento.

Como alternativa, adicione um drive.homepageTrigger ao manifesto do complemento para fornecer uma página inicial específica do Drive.

Em ambos os casos, é necessário fornecer o nome de uma função de gatilho da página inicial no projeto de script do seu complemento. Essa função é chamada automaticamente para criar a página inicial do Drive quando necessário. É necessário implementar essa função para criar e retornar um único Card ou uma matriz de objetos Card que compõem a página inicial. A função de gatilho da página inicial recebe um objeto de evento como um parâmetro que contém algumas informações gerais, como o URL de plataforma. Você pode usar os dados do objeto de evento para personalizar a construção do página inicial.

Gerar interface contextual para itens selecionados

O Google Drive usa um gatilho contextual para determinar qual interface (se houver) para ser exibido quando o usuário selecionar um ou mais itens do Google Drive. Quando o gatilho é acionado, ele executa a função de gatilho contextual especificada pelo campo drive.onItemsSelectedTrigger.runFunction no manifesto do complemento.

Para criar uma interface de seleção de itens contextuais para o Drive, faça o seguinte: seguintes:

O manifesto do complemento precisa incluir o escopo https://www.googleapis.com/auth/drive.addons.metadata.readonly.
Verifique se o manifesto inclui uma seção drive.onItemsSelectedTrigger.
Implemente a função nomeada no campo drive.onItemsSelectedTrigger. Essa função aceita um objeto de evento como argumento e precisa retornar um único objeto Card ou uma matriz de objetos Card.
Como acontece com qualquer cartão, é necessário implementar as funções de callback usadas para fornecer com interatividade de widgets na interface. Por exemplo, se você incluir um botão na interface, ele precisará ter uma ação e uma função de callback implementada que serão executadas quando o botão for clicado.

Objetos de evento

Um objeto de evento é criado e transmitido para drive.homepageTrigger ou drive.onItemsSelectedTrigger função de gatilho quando essas funções são chamadas. A função de acionamento pode usar as informações neste objeto de evento para determinar como construir cards de complementos ou controlar o comportamento do complemento.

A estrutura completa dos objetos de evento é descrita em Objetos de evento. Quando o Drive é o app host de ação do complemento, os objetos de eventos contextuais incluem o parâmetro Objeto de evento do Drive que mostra informações do cliente específicas do Drive.

Os objetos de evento do Drive contextual para acionadores de seleção de itens incluem informações sobre os itens que o usuário selecionou quando o acionador foi acionado. Quando um usuário seleciona mais de um item no Drive, um deles é considerado de interesse principal. Esse item é chamado de item do cursor ativo.

O exemplo a seguir mostra Objeto de evento do Drive que é passado para um drive.onItemsSelectedTrigger função:

    {
      "commonEventObject": { ... },
      "drive": {
        "activeCursorItem":{
          "addonHasFileScopePermission": true,
          "id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
          "iconUrl": "https://drive-thirdparty.googleusercontent.com...",
          "mimeType":"application/pdf",
          "title":"How to get started with Drive"
        },
        "selectedItems": [
          {
            "addonHasFileScopePermission": true,
            "id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
            "iconUrl":"https://drive-thirdparty.googleusercontent.com...",
            "mimeType":"application/pdf",
            "title":"How to get started with Drive"
          },
          ...
        ]
      },
      ...
    }