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

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

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

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

  • "डिफ़ॉल्ट MIME टाइप" फ़ील्ड में बताए गए MIME टाइप के लिए, फ़ाइल आईडी को आपके ऐप्लिकेशन पर भेजा जाता है. ऐप्लिकेशन के हिसाब से फ़ाइलों को मैनेज करने के तरीके के बारे में जानने के लिए, ऐप्लिकेशन के हिसाब से दस्तावेज़ों के लिए, Open URL को मैनेज करना लेख पढ़ें.

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

    Google Workspace फ़ाइलों को मैनेज करने के तरीके के बारे में जानने के लिए, Google Workspace दस्तावेज़ों के लिए, ओपन यूआरएल मैनेज करना लेख पढ़ें. Google Workspace के दस्तावेज़ों और एमआईएमई टाइप के कन्वर्ज़न फ़ॉर्मैट की सूची देखने के लिए, 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: प्रोफ़ाइल आईडी, जो उपयोगकर्ता की पहचान करता है.

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

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

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

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: वह प्रोफ़ाइल आईडी जिससे उपयोगकर्ता की पहचान होती है.

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

  1. पुष्टि करें कि यह state फ़ील्ड में open वैल्यू और exportIds फ़ील्ड की मौजूदगी, दोनों का पता लगाकर फ़ाइल को खोलने का अनुरोध है.

  2. अनुमतियों की जांच करने, फ़ाइल का मेटाडेटा फ़ेच करने, और EXPORT_ID वैल्यू का इस्तेमाल करके MIME टाइप तय करने के लिए, files.get तरीके का इस्तेमाल करें.

  3. files.export तरीके का इस्तेमाल करके, फ़ाइल के कॉन्टेंट को बदलें. यहां दिए गए कोड के सैंपल में, Google Workspace दस्तावेज़ को, अनुरोध किए गए MIME टाइप में एक्सपोर्ट करने का तरीका बताया गया है.

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

    Java

    drive/snippets/drive_v3/src/main/java/ExportPdf.java
    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
    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
    /**
     * 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
    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 पैरामीटर को यूआरएल से कोड में बदला गया है. इसलिए, आपके ऐप्लिकेशन को एस्केप वर्ण मैनेज करने होंगे और उसे JSON के तौर पर पार्स करना होगा.

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

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

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