이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google Drive 인터페이스 빌드

Google Workspace 부가기능은 Google Drive의 인터페이스가 표시됩니다. 이를 통해 사용자는 추가 관련 정보 제공, 작업 자동화, 서드 파티 파트너 연결 Google Drive에 복원하기만 하면 됩니다.

부가기능 UI 액세스

다음에서 Google Workspace 부가기능을 열 수 있습니다. Google Drive 아이콘이 아이콘 열에 표시됩니다. 가 Google Workspace 부가기능은 홈페이지 인터페이스나 항목 선택 인터페이스 또는 둘 다를 정의합니다.

사용자가 Google Drive에서 부가기능 아이콘을 클릭하면 부가기능은 해당하는 drive.homepageTrigger 함수 (있는 경우)를 지정합니다. 이 함수 홈페이지 카드를 빌드하고 반환합니다. 표시되도록 할 수 있습니다. 답이 '아니요'인 경우 drive.homepageTrigger 드림 함수가 정의되면 일반 홈페이지 카드가 대신 표시됩니다.
사용자가 Google Drive에서 하나 이상의 항목을 선택한 다음 부가기능을 클릭하는 경우 아이콘을 클릭하거나 부가기능이 열려 있는 동안 항목을 선택하면 부가기능이 해당하는 drive.onItemsSelectedTrigger 드림 문맥 함수 (있는 경우) 이 함수는 부가기능의 Google Drive를 빌드합니다. 문맥 '항목 선택됨' 인터페이스 Google Drive에 반환하여 표시합니다.

부가기능 Drive 인터페이스 빌드

다음의 일반적인 방법에 따라 Google Drive를 확장하는 인터페이스를 구축할 수 있습니다. 단계:

부가기능에 Drive 전용을 포함할지 결정 홈페이지로 이동합니다. 또한 사용자가 광고를 보는 경우를 위해 컨텍스트 인터페이스를 제공할지 여부도 결정합니다. Drive 항목을 선택합니다.
해당하는 addOns.common 및 addOns.drive 입력란을 다음으로 부가기능 스크립트 프로젝트 매니페스트에 필요한 모든 Drive 범위.
Drive 전용 홈페이지를 제공하는 경우 구현하고 drive.homepageTrigger 함수를 사용하여 이 인터페이스를 빌드합니다. 또한 common.homepageTrigger 드림 여러 Google Workspace 호스트에 사용할 수 있는 인터페이스입니다
Drive 상황별 항목 선택 인터페이스를 제공하는 경우 drive.onItemsSelectedTrigger 구현 컨텍스트 트리거 함수를 사용하여 이 인터페이스를 빌드합니다. 선택한 항목의 Drive 컨텍스트 인터페이스를 참고하세요.) 참조하세요.
사용자의 버튼 클릭과 같은 UI 상호작용

드라이브 홈페이지

Google Drive에서 Google Workspace 부가기능 표시 지원 홈페이지를 엽니다. Google Drive에 부가기능의 일반 홈페이지를 표시하려면 addOns.drive 필드 할 수 있습니다.

또는 drive.homepageTrigger 드림 부가기능 매니페스트에 추가하여 드라이브 전용 홈페이지를 제공합니다.

어떤 경우든 부가기능의 스크립트 프로젝트에서 작성할 수 있습니다 이 함수는 필요할 때 드라이브 홈페이지 이 함수를 구현해야 하는 경우 단일 Card 또는 Card 드림 객체를 정의합니다. 홈페이지 트리거 함수는 이벤트 객체 를 있습니다. 이벤트 객체 데이터를 사용하여 있습니다.

선택한 항목의 Drive 컨텍스트 인터페이스

Google Drive는 상황별 트리거를 사용하여 어떤 인터페이스를 (있는 경우) - 사용자가 하나 이상의 Google Drive 항목을 선택할 때 표시할 수 있습니다. 이 트리거가 실행되면 drive.onItemsSelectedTrigger.runFunction 드림 부가기능 매니페스트에 있는지 확인합니다.

Drive의 상황별 항목 선택 인터페이스를 만들려면 다음을 실행해야 합니다. 있습니다.

부가기능의 매니페스트에 https://www.googleapis.com/auth/drive.addons.metadata.readonly 범위
매니페스트에 drive.onItemsSelectedTrigger 드림 섹션으로 이동합니다.
drive.onItemsSelectedTrigger 드림 필드를 확인합니다. 이 함수는 이벤트 객체를 인수로 허용합니다. 는 Card 객체 또는 Card 객체를 반환합니다.
다른 카드와 마찬가지로 상호작용을 위한 인터페이스를 제공합니다. 예를 들어 인터페이스에 조치 버튼 클릭 시 실행되는 구현된 콜백 함수가 있습니다.

이벤트 객체

이벤트 객체가 생성되고 전달됨 drive.homepageTrigger(으)로 또는 drive.onItemsSelectedTrigger 해당 함수가 호출되면 함수를 트리거하게 됩니다. 트리거 함수는 이 이벤트 객체의 정보를 사용하여 부가기능 카드 구성 방법을 결정합니다. 부가기능 동작을 제어할 수 있습니다.

이벤트 객체의 전체 구조는 다음에 설명되어 있습니다. 이벤트 객체. Drive가 부가기능의 실행 호스트 앱인 경우, 컨텍스트 이벤트 객체 포함 Drive 이벤트 객체 필드로 대체되었습니다.

항목 선택 트리거의 컨텍스트 Drive 이벤트 객체에는 다음이 포함됩니다. 사용자가 선택한 항목에 대한 정보를 볼 수 있습니다. 사용자가 Drive에서 2개 이상의 항목을 선택한 경우 항목 중 하나는 다음 중 하나로 간주됩니다. 1차 관심분야 이 항목을 활성 커서 항목이라고 합니다.

다음 예는 Drive 이벤트 객체 이 포드는 drive.onItemsSelectedTrigger 함수:

    {
      "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"
          },
          ...
        ]
      },
      ...
    }