Membuat file pintasan ke konten yang disimpan oleh aplikasi Anda

Pintasan pihak ketiga di Google Drive adalah file khusus metadata yang ditautkan ke file lain di sistem penyimpanan eksternal milik pihak ketiga. Pintasan ini berfungsi sebagai link referensi ke file "konten" yang disimpan oleh aplikasi di luar Drive, biasanya di sistem penyimpanan cloud atau datastore yang berbeda.

Untuk membuat pintasan pihak ketiga, gunakan metode files.create Google Drive API dan tetapkan jenis MIME ke application/vnd.google-apps.drive-sdk. Jangan upload konten apa pun saat membuat file. Untuk mengetahui informasi selengkapnya, lihat Jenis MIME yang didukung Google Workspace dan Google Drive types.

Anda tidak dapat mengupload atau mendownload pintasan pihak ketiga.

Catatan: Jika menggunakan Drive API v2 yang lebih lama, Anda dapat menemukan contoh kode di GitHub. Pelajari cara bermigrasi ke Drive API v3.

Contoh kode berikut menunjukkan cara membuat pintasan pihak ketiga menggunakan library klien:

Java

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

Lihat di 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

Lihat di 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

Lihat di 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

Lihat di 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

Lihat di 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;
}

Catatan: Jika Anda menjalankan contoh ini menggunakan Akun Layanan (yang merupakan default saat menggunakan Kredensial Default Aplikasi di banyak lingkungan), file pintasan akan dibuat di penyimpanan Drive terisolasi Akun Layanan. File tersebut tidak akan terlihat di situs Drive untuk akun pengguna pribadi Anda, kecuali jika Anda membagikan file tersebut ke alamat email pengguna atau mengotorisasi permintaan melalui kredensial OAuth 2.0 pengguna. Selain itu, agar pintasan berfungsi dan mengalihkan ke aplikasi Anda saat diklik, Anda harus mengonfigurasi integrasi UI Drive dengan URL Terbuka dan menginstal aplikasi yang sesuai.

Cara kerja pintasan pihak ketiga

Saat Anda membuat pintasan pihak ketiga menggunakan metode files.create, pintasan tersebut akan menggunakan permintaan POST untuk menyisipkan metadata dan membuat pintasan ke konten aplikasi Anda:

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

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

Saat pintasan pihak ketiga diklik, pengguna akan dialihkan ke situs eksternal tempat file disimpan. ID file Drive terdapat dalam parameter state. Untuk mengetahui informasi selengkapnya, lihat Menangani URL Terbuka untuk dokumen khusus aplikasi.

Aplikasi atau situs pihak ketiga kemudian bertanggung jawab untuk mencocokkan ID file dalam parameter state dengan konten yang disimpan dalam sistemnya.

Menambahkan thumbnail kustom dan teks yang dapat diindeks

Untuk meningkatkan visibilitas file yang terkait dengan pintasan pihak ketiga, Anda dapat mengupload gambar thumbnail dan teks yang dapat diindeks saat menyisipkan atau mengubah metadata file. Untuk mengetahui informasi selengkapnya, lihat Mengelola metadata file.

Topik terkait

• Membuat pintasan ke file Drive
• Mengonfigurasi integrasi UI Drive
• Jenis MIME yang didukung Google Workspace dan Google Drive