앱에 저장된 콘텐츠의 바로가기 파일 만들기

Google Drive의 서드 파티 바로가기 는 외부의 서드 파티 소유 스토리지 시스템에 있는 다른 파일에 연결되는 메타데이터 전용 파일입니다. 이러한 바로가기는 일반적으로 다른 데이터 저장소 또는 클라우드 스토리지 시스템에서 Drive 외부의 애플리케이션에 의해 저장된 '콘텐츠' 파일에 대한 참조 링크 역할을 합니다.

서드 파티 바로가기를 만들려면 Google Drive API의 files.create 메서드를 사용하고 MIME 유형을 application/vnd.google-apps.drive-sdk로 설정합니다. 파일을 만들 때 콘텐츠를 업로드하지 마세요. 자세한 내용은 Google Workspace 및 Google Drive에서 지원되는 MIME 유형을 참고하세요.

서드 파티 바로가기를 업로드하거나 다운로드할 수는 없습니다.

참고: 이전 Drive API v2를 사용하는 경우 GitHub에서 코드 샘플을 찾을 수 있습니다. Drive API v3으로 마이그레이션하는 방법을 알아보세요.

다음 코드 샘플은 클라이언트 라이브러리를 사용하여 서드 파티 바로가기를 만드는 방법을 보여줍니다.

자바

drive/snippets/drive_v3/src/main/java/CreateShortcut.java

GitHub에서 보기

import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.drive.Drive;
import com.google.api.services.drive.DriveScopes;
import com.google.api.services.drive.model.File;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.Arrays;

/* Class to demonstrate Drive's create shortcut use-case */
public class CreateShortcut {

  /**
   * Creates shortcut for file.
   *
   * @throws IOException if service account credentials file not found.
   */
  public static String createShortcut() throws IOException {
        /* Load pre-authorized user credentials from the environment.
        TODO(developer) - See https://developers.google.com/identity for
        guides on implementing OAuth2 for your application.*/
    GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
        .createScoped(Arrays.asList(DriveScopes.DRIVE_FILE));
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);
    // Build a new authorized API client service.
    Drive service = new Drive.Builder(new NetHttpTransport(),
        GsonFactory.getDefaultInstance(),
        requestInitializer)
        .setApplicationName("Drive samples")
        .build();
    try {
      // Create Shortcut for file.
      File fileMetadata = new File();
      fileMetadata.setName("Project plan");
      fileMetadata.setMimeType("application/vnd.google-apps.drive-sdk");

      File file = service.files().create(fileMetadata)
          .setFields("id")
          .execute();
      System.out.println("File ID: " + file.getId());
      return file.getId();
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to create shortcut: " + e.getDetails());
      throw e;
    }
  }
}

Python

drive/snippets/drive-v3/file_snippet/create_shortcut.py

GitHub에서 보기

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def create_shortcut():
  """Create a third party shortcut

  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()

  try:
    # create drive api client
    service = build("drive", "v3", credentials=creds)
    file_metadata = {
        "name": "Project plan",
        "mimeType": "application/vnd.google-apps.drive-sdk",
    }

    # pylint: disable=maybe-no-member
    file = service.files().create(body=file_metadata, fields="id").execute()
    print(f'File ID: {file.get("id")}')

  except HttpError as error:
    print(f"An error occurred: {error}")
  return file.get("id")


if __name__ == "__main__":
  create_shortcut()

PHP

drive/snippets/drive_v3/src/DriveCreateShortcut.php

GitHub에서 보기

<?php
use Google\Client;
use Google\Service\Drive;
use Google\Service\Drive\DriveFile;
function createShortcut()
{
    try {

        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $fileMetadata = new DriveFile(array(
            'name' => 'Project plan',
            'mimeType' => 'application/vnd.google-apps.drive-sdk'));
        $file = $driveService->files->create($fileMetadata, array(
            'fields' => 'id'));
        printf("File ID: %s\n", $file->id);
        return $file->id;

    } catch(Exception $e) {
        echo "Error Message: ".$e;
    }

}

.NET

drive/snippets/drive_v3/DriveV3Snippets/CreateShortcut.cs

GitHub에서 보기

using Google.Apis.Auth.OAuth2;
using Google.Apis.Drive.v3;
using Google.Apis.Services;

namespace DriveV3Snippets
{
    // Class to demonstrate Drive's create shortcut use-case
    public class CreateShortcut
    {
        /// <summary>
        /// Create a third party shortcut.
        /// </summary>
        /// <returns>newly created shortcut file id, null otherwise.</returns>
        public static string DriveCreateShortcut()
        {
            try
            {
                /* Load pre-authorized user credentials from the environment.
                 TODO(developer) - See https://developers.google.com/identity for 
                 guides on implementing OAuth2 for your application. */
                GoogleCredential credential = GoogleCredential
                    .GetApplicationDefault()
                    .CreateScoped(DriveService.Scope.Drive);

                // Create Drive API service.
                var service = new DriveService(new BaseClientService.Initializer
                {
                    HttpClientInitializer = credential,
                    ApplicationName = "Drive API Snippets"
                });

                // Create Shortcut for file.
                var fileMetadata = new Google.Apis.Drive.v3.Data.File()
                {
                    Name = "Project plan",
                    MimeType = "application/vnd.google-apps.drive-sdk"
                };
                var request = service.Files.Create(fileMetadata);
                request.Fields = "id";
                var file = request.Execute();
                // Prints the shortcut file id.
                Console.WriteLine("File ID: " + file.Id);
                return file.Id;
            }
            catch (Exception e)
            {
                // TODO(developer) - handle error appropriately
                if (e is AggregateException)
                {
                    Console.WriteLine("Credential Not found");
                }
                else
                {
                    throw;
                }
            }
            return null;
        }
    }
}

Node.js

drive/snippets/drive_v3/file_snippets/create_shortcut.js

GitHub에서 보기

import {GoogleAuth} from 'google-auth-library';
import {google} from 'googleapis';

/**
 * Creates a shortcut to a third-party resource.
 * @return {Promise<string|null|undefined>} The shortcut ID.
 */
async function createShortcut() {
  // Authenticate with Google and get an authorized client.
  // TODO (developer): Use an appropriate auth mechanism for your app.
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });

  // Create a new Drive API client (v3).
  const service = google.drive({version: 'v3', auth});

  // The metadata for the new shortcut.
  const fileMetadata = {
    name: 'Project plan',
    mimeType: 'application/vnd.google-apps.drive-sdk',
  };

  // Create the new shortcut.
  const file = await service.files.create({
    requestBody: fileMetadata,
    fields: 'id',
  });

  // Print the ID of the new shortcut.
  console.log('File Id:', file.data.id);
  return file.data.id;
}

참고: 서비스 계정을 사용하여 이러한 샘플을 실행하는 경우 (많은 환경에서 애플리케이션 기본 사용자 인증 정보를 사용할 때 기본값임) 바로가기 파일이 서비스 계정의 격리된 Drive 저장소에 생성됩니다. 사용자 이메일 주소와 파일을 공유하거나 사용자 OAuth 2.0 사용자 인증 정보를 통해 요청을 승인하지 않는 한 개인 사용자 계정의 Drive 웹사이트에 표시되지 않습니다. 또한 바로가기가 작동하고 클릭 시 앱으로 리디렉션되도록 하려면 열기 URL로 Drive UI 통합을 구성하고 해당 앱을 설치해야 합니다.

서드 파티 바로가기의 작동 방식

files.create 메서드를 사용하여 서드 파티 바로가기를 만들면 POST 요청을 사용하여 메타데이터를 삽입하고 앱 콘텐츠의 바로가기를 만듭니다.

POST https://www.googleapis.com/drive/v3/files
Authorization: AUTHORIZATION_HEADER

{
  "title": "FILE_TITLE",
  "mimeType": "application/vnd.google-apps.drive-sdk"
}

서드 파티 바로가기를 클릭하면 파일이 있는 외부 사이트로 사용자가 리디렉션됩니다. Drive 파일 ID는 state 매개변수에 포함되어 있습니다. 자세한 내용은 앱별 문서의 열기 URL 처리를 참고하세요.

그러면 서드 파티 앱 또는 웹사이트에서 state 매개변수의 파일 ID를 시스템 내에 있는 콘텐츠와 일치시켜야 합니다.

맞춤 미리보기 이미지 및 색인 생성 가능한 텍스트 추가

서드 파티 바로가기와 연결된 파일의 검색 가능성을 높이려면 파일 메타데이터를 삽입하거나 수정할 때 미리보기 이미지와 색인 생성 가능한 텍스트를 모두 업로드하면 됩니다. 자세한 내용은 파일 메타데이터 관리를 참고하세요.

관련 주제

• Drive 파일의 바로가기 만들기
• Drive UI 통합 구성
• Google Workspace 및 Google Drive에서 지원되는 MIME 유형