इस पेज का अनुवाद Cloud Translation API से किया गया है.

Drive के यूआई's "के साथ खोलें" संदर्भ मेन्यू के साथ इंटिग्रेट करें

जब कोई उपयोगकर्ता कोई फ़ाइल चुनता है और Drive के यूज़र इंटरफ़ेस (यूआई) के "इससे खोलें" मेन्यू आइटम पर क्लिक करता है, तो Drive, उपयोगकर्ता को उस ऐप्लिकेशन के ओपन यूआरएल पर रीडायरेक्ट कर देता है. यह यूआरएल, Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को कॉन्फ़िगर करें में बताया गया है.

अगर आपने Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को कॉन्फ़िगर करते समय "इंपोर्ट किया जा रहा है" बॉक्स चुना है, तो उपयोगकर्ता खोलने के लिए खास ऐप्लिकेशन और Google Workspace फ़ाइलों का कॉम्बिनेशन चुन सकता है. Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को कॉन्फ़िगर करने पर, ऐप्लिकेशन के हिसाब से बनी फ़ाइलें "डिफ़ॉल्ट MIME टाइप" और "डिफ़ॉल्ट फ़ाइल एक्सटेंशन" फ़ील्ड में दिखती हैं. वहीं, Google Workspace की फ़ाइलें, "सेकंडरी MIME टाइप" और "सेकंडरी फ़ाइल एक्सटेंशन" फ़ील्ड में तय की जाती हैं.

हर उस फ़ाइल के लिए जिसे उपयोगकर्ता खोलना चाहता है, Drive आपके तय किए गए डिफ़ॉल्ट और दूसरे MIME टाइप से MIME टाइप की जांच करता है:

"डिफ़ॉल्ट MIME टाइप" फ़ील्ड में बताए गए MIME टाइप के लिए, फ़ाइल आईडी आपके ऐप्लिकेशन को पास किया जाता है. ऐप्लिकेशन से जुड़ी खास फ़ाइलों को मैनेज करने के तरीके के बारे में जानकारी के लिए, ऐप्लिकेशन से जुड़े दस्तावेज़ों के लिए, ओपन यूआरएल मैनेज करना देखें.
"सेकंडरी MIME टाइप" फ़ील्ड में बताए गए MIME टाइप के लिए, Drive के यूज़र इंटरफ़ेस पर एक डायलॉग बॉक्स दिखता है. इस डायलॉग में उपयोगकर्ता से पूछा जाता है कि Google Workspace फ़ाइल को किस तरह के फ़ाइल टाइप में बदला जाए. उदाहरण के लिए, अगर Drive के यूज़र इंटरफ़ेस (यूआई) में कोई Google Docs फ़ाइल चुनी जाती है और "सेकंडरी MIME टाइप" फ़ील्ड से आपको अपने ऐप्लिकेशन में टेक्स्ट/सामान्य या ऐप्लिकेशन/pdf का सुझाव मिलता है, तो Drive का यूज़र इंटरफ़ेस (यूआई) उपयोगकर्ता से पूछता है कि क्या उन्हें सामान्य टेक्स्ट या PDF में बदलना है.

Google Workspace की फ़ाइलों को मैनेज करने का तरीका जानने के लिए, Google Workspace दस्तावेज़ों के लिए, ओपन यूआरएल मैनेज करना देखें. Google Workspace दस्तावेज़ों और MIME टाइप कन्वर्ज़न फ़ॉर्मैट की सूची के लिए, Google Workspace दस्तावेज़ों के लिए MIME टाइप एक्सपोर्ट करें देखें.

ऐप्लिकेशन के दस्तावेज़ों के लिए, ओपन यूआरएल मैनेज करना

जैसा कि Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को कॉन्फ़िगर करना लेख में बताया गया है, आपके ऐप्लिकेशन को टेंप्लेट वैरिएबल मिलते हैं. इन वैरिएबल पर जानकारी होती है, ताकि ऐप्लिकेशन फ़ाइल खोल सके. आपके ऐप्लिकेशन को state पैरामीटर में, टेंप्लेट वैरिएबल का डिफ़ॉल्ट सेट मिलता है. ऐप्लिकेशन के लिए खास तौर पर बने, यूआरएल खोलने के लिए state की डिफ़ॉल्ट जानकारी यह है:

{
  "ids": ["ID"],
  "resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
  "action":"open",
  "userId":"USER_ID"
}

इस आउटपुट में ये वैल्यू शामिल होती हैं:

ID: पैरंट फ़ोल्डर का आईडी.
RESOURCE_KEYS: फ़ाइल आईडी की एक JSON डिक्शनरी, जिसे उनसे जुड़े संसाधन कुंजियों से मैप किया गया है.
open: की जाने वाली कार्रवाई. खुले यूआरएल का इस्तेमाल करते समय वैल्यू open होती है.
USER_ID: प्रोफ़ाइल आईडी, जिससे किसी व्यक्ति की पहचान होती है.

आपके ऐप्लिकेशन को इस अनुरोध पर कार्रवाई करने के लिए, यह तरीका अपनाना होगा:

पुष्टि करें कि action फ़ील्ड की वैल्यू open हो और ids फ़ील्ड मौजूद हो.
उपयोगकर्ता के लिए एक नया सेशन बनाने के लिए, userId वैल्यू का इस्तेमाल करें. साइन इन किए हुए उपयोगकर्ताओं के बारे में ज़्यादा जानकारी के लिए, उपयोगकर्ता और नए इवेंट देखें.
अनुमतियां देखने, फ़ाइल मेटाडेटा फ़ेच करने, और ID वैल्यू का इस्तेमाल करके फ़ाइल का कॉन्टेंट डाउनलोड करने के लिए, files.get वाला तरीका इस्तेमाल करें.
अगर resourceKeys को अनुरोध पर सेट किया गया था, तो X-Goog-Drive-Resource-Keys अनुरोध का हेडर सेट करें. संसाधन कुंजियों के बारे में ज़्यादा जानकारी के लिए, संसाधन कुंजियों का इस्तेमाल करके लिंक से शेयर की गई फ़ाइलें ऐक्सेस करना देखें.

state पैरामीटर, यूआरएल के हिसाब से कोड में बदला जाता है. इसलिए, आपके ऐप्लिकेशन को एस्केप कैरेक्टर को हैंडल करना होगा और उसे JSON के तौर पर पार्स करना होगा.

ध्यान दें: सभी ऐप्लिकेशन में, किसी दस्तावेज़ के लिए उपयोगकर्ता की अनुमतियों की जांच करने के लिए, files.get तरीके का इस्तेमाल करना चाहिए. इसमें, शॉर्टकट और तीसरे पक्ष के शॉर्टकट से फ़ाइलें खोलने वाले ऐप्लिकेशन भी शामिल हैं. जब ऐप्लिकेशन ऐसी फ़ाइल खोलते हैं, तो उसे रीड-ओनली ऐक्सेस वाले उपयोगकर्ताओं को चेतावनी देनी चाहिए कि वे फ़ाइल में बदलाव नहीं कर सकते या उसे सेव नहीं कर सकते. इस बात का ध्यान रखें कि ऐप्लिकेशन में बदलाव करने के लिए समय न दिया जाए और सेव करने पर गड़बड़ी दिखती हो.

Google Workspace के दस्तावेज़ों के लिए, ओपन यूआरएल मैनेज करना

जैसा कि Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को कॉन्फ़िगर करना लेख में बताया गया है, आपके ऐप्लिकेशन को state पैरामीटर में, टेंप्लेट वैरिएबल का डिफ़ॉल्ट सेट मिलता है. Google Workspace के ओपन यूआरएल के लिए, state की डिफ़ॉल्ट जानकारी यह होती है:

{
  "exportIds": ["ID"],
  "resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
  "action":"open",
  "userId":"USER_ID"
}

इस आउटपुट में ये वैल्यू शामिल होती हैं:

EXPORT_ID: एक्सपोर्ट किए जा रहे फ़ाइल आईडी की कॉमा-सेपरेटेड लिस्ट. इसका इस्तेमाल सिर्फ़ पहले से मौजूद Google दस्तावेज़ों को खोलने पर किया जाता है.
RESOURCE_KEYS: फ़ाइल आईडी की एक JSON डिक्शनरी, जिसे उनसे जुड़े संसाधन कुंजियों से मैप किया गया है.
open: की जाने वाली कार्रवाई. खुले यूआरएल का इस्तेमाल करते समय वैल्यू open होती है.
USER_ID: वह प्रोफ़ाइल आईडी जिससे उपयोगकर्ता की पहचान होती है.

आपके ऐप्लिकेशन को इस अनुरोध पर कार्रवाई करने के लिए, यह तरीका अपनाना होगा:

पुष्टि करें कि यह अनुरोध, किसी फ़ाइल को खोलने के लिए किया गया है. इसके लिए, state फ़ील्ड में open वैल्यू और exportIds फ़ील्ड, दोनों का पता लगाएं.
अनुमतियां देखने, फ़ाइल मेटाडेटा फ़ेच करने, और EXPORT_ID वैल्यू का इस्तेमाल करके MIME टाइप तय करने के लिए, files.get वाला तरीका इस्तेमाल करें.
files.export तरीके का इस्तेमाल करके फ़ाइल का कॉन्टेंट बदलें. नीचे दिए गए कोड सैंपल में, Google Workspace दस्तावेज़ को अनुरोध किए गए MIME टाइप में एक्सपोर्ट करने का तरीका बताया गया है.

अगर resourceKey को अनुरोध पर सेट किया गया था, तो X-Goog-Drive-Resource-Keys अनुरोध का हेडर सेट करें. संसाधन कुंजियों के बारे में ज़्यादा जानकारी के लिए, संसाधन कुंजियों का इस्तेमाल करके लिंक से शेयर की गई फ़ाइलें ऐक्सेस करना देखें.

Java

drive/snippets/drive_v3/src/main/java/ExportPdf.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.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Arrays;

/* Class to demonstrate use-case of drive's export pdf. */
public class ExportPdf {

  /**
   * Download a Document file in PDF format.
   *
   * @param realFileId file ID of any workspace document format file.
   * @return byte array stream if successful, {@code null} otherwise.
   * @throws IOException if service account credentials file not found.
   */
  public static ByteArrayOutputStream exportPdf(String realFileId) 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();

    OutputStream outputStream = new ByteArrayOutputStream();
    try {
      service.files().export(realFileId, "application/pdf")
          .executeMediaAndDownloadTo(outputStream);

      return (ByteArrayOutputStream) outputStream;
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      System.err.println("Unable to export file: " + e.getDetails());
      throw e;
    }
  }
}

Python

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

GitHub पर देखें

import io

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


def export_pdf(real_file_id):
  """Download a Document file in PDF format.
  Args:
      real_file_id : file ID of any workspace document format file
  Returns : IO object with location

  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_id = real_file_id

    # pylint: disable=maybe-no-member
    request = service.files().export_media(
        fileId=file_id, mimeType="application/pdf"
    )
    file = io.BytesIO()
    downloader = MediaIoBaseDownload(file, request)
    done = False
    while done is False:
      status, done = downloader.next_chunk()
      print(f"Download {int(status.progress() * 100)}.")

  except HttpError as error:
    print(f"An error occurred: {error}")
    file = None

  return file.getvalue()


if __name__ == "__main__":
  export_pdf(real_file_id="1zbp8wAyuImX91Jt9mI-CAX_1TqkBLDEDcr2WeXBbKUY")

Node.js

drive/snippets/drive_v3/file_snippets/export_pdf.js

GitHub पर देखें

/**
 * Download a Document file in PDF format
 * @param{string} fileId file ID
 * @return{obj} file status
 * */
async function exportPdf(fileId) {
  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const service = google.drive({version: 'v3', auth});

  try {
    const result = await service.files.export({
      fileId: fileId,
      mimeType: 'application/pdf',
    });
    console.log(result.status);
    return result;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
}

PHP

drive/snippets/drive_v3/src/DriveExportPdf.php

GitHub पर देखें

use Google\Client;
use Google\Service\Drive;
function exportPdf()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $realFileId = readline("Enter File Id: ");
        $fileId = '1ZdR3L3qP4Bkq8noWLJHSr_iBau0DNT4Kli4SxNc2YEo';
        $fileId = $realFileId;
        $response = $driveService->files->export($fileId, 'application/pdf', array(
            'alt' => 'media'));
        $content = $response->getBody()->getContents();
        return $content;

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

}

बदली गई फ़ाइलों को रीड-ओनली के तौर पर दिखाएं या ऐसा डायलॉग दिखाएं जिससे लोग फ़ाइल को नए फ़ाइल टाइप के तौर पर सेव कर सकें.

उपयोगकर्ता और नए इवेंट

डिस्क ऐप्लिकेशन को सभी "खुला है" इवेंट को संभावित साइन-इन मानते हुए होना चाहिए. कुछ उपयोगकर्ताओं के पास एक से ज़्यादा खाते हो सकते हैं, इसलिए हो सकता है कि state पैरामीटर में मौजूद यूज़र आईडी, मौजूदा सेशन से मेल न खाए. अगर state पैरामीटर में मौजूद यूज़र आईडी मौजूदा सेशन से मेल नहीं खाता है, तो अपने ऐप्लिकेशन का मौजूदा सेशन खत्म करें और अनुरोध किए गए उपयोगकर्ता के तौर पर साइन इन करें.

मिलते-जुलते विषय

ऐप्लिकेशन में, Google Drive के यूज़र इंटरफ़ेस (यूआई) से एक ऐप्लिकेशन खोलने के अलावा, ऐप्लिकेशन में से कॉन्टेंट चुनने के लिए फ़ाइल पिकर भी दिख सकता है. ज़्यादा जानकारी के लिए, Google पिकर देखें.