Drive UI-এর "এর মাধ্যমে খুলুন" সংশ্লিষ্ট মেনুর সাথে ইন্টিগ্রেট করুন

ব্যবহারকারী কোনও ফাইল বেছে নিয়ে Drive UI-এর "এতে খুলুন " মেনু আইটেমে ক্লিক করলে, Drive ব্যবহারকারীকে Drive UI ইন্টিগ্রেশন কনফিগার করুন বিকল্পে উল্লেখ করা অ্যাপের 'URL খুলুন' বিকল্পে রিডাইরেক্ট করে।

Drive UI ইন্টিগ্রেশন কনফিগার করার সময় আপনি "ইমপোর্ট করা হচ্ছে" বক্সে টিকচিহ্ন দিয়ে থাকলে, ব্যবহারকারী খোলার জন্য অ্যাপ-নির্দিষ্ট এবং Google Workspace ফাইলের একটি কম্বিনেশন বেছে নিতে পারবেন। আপনি যখন Drive UI ইন্টিগ্রেশন কনফিগার করেন, তখন অ্যাপ-নির্দিষ্ট ফাইলগুলি "ডিফল্ট MIME প্রকার" এবং "ডিফল্ট ফাইল এক্সটেনশন" ফিল্ডে সংজ্ঞায়িত করা হয়, যেখানে Google Workspace ফাইলগুলি "সেকেন্ডারি MIME প্রকার" এবং "সেকেন্ডারি ফাইল এক্সটেনশন" ফিল্ডে সংজ্ঞায়িত করা হয়।

ব্যবহারকারী যে ফাইল খুলতে চান, Drive সেটির MIME টাইপ আপনার নির্ধারিত ডিফল্ট ও সেকেন্ডারি MIME টাইপের সাথে মিলিয়ে দেখে:

  • "ডিফল্ট MIME-এর প্রকার" ফিল্ডে উল্লেখ করা MIME-এর প্রকারের জন্য, ফাইল আইডি আপনার অ্যাপে পাঠানো হয়। অ্যাপ-নির্দিষ্ট ফাইল কীভাবে ম্যানেজ করতে হয় সেই সম্পর্কে তথ্যের জন্য, অ্যাপ-নির্দিষ্ট ডকুমেন্টের জন্য একটি ওপেন URL ম্যানেজ করুন দেখুন।

  • "সেকেন্ডারি MIME-এর প্রকার" ফিল্ডে উল্লেখ করা MIME-এর প্রকারের জন্য, Drive UI একটি ডায়ালগ দেখায় যেখানে ব্যবহারকারীকে জিজ্ঞাসা করা হয় যে Google Workspace ফাইলটি কোন ফাইলের প্রকারে পরিবর্তন করতে হবে। যেমন, আপনি Drive UI-তে কোনও Google Docs ফাইল বেছে নিলে এবং "সেকেন্ডারি MIME-এর প্রকার" ফিল্ডে আপনার অ্যাপ text/plain বা application/pdf সাপোর্ট করে বলে সাজেস্ট করলে, Drive UI ব্যবহারকারীকে জিজ্ঞাসা করে যে তিনি প্লেন টেক্সট বা PDF-এ কনভার্ট করতে চান কিনা।

    Google Workspace ফাইল কীভাবে ম্যানেজ করতে হয় সেই সম্পর্কে জানতে, Google Workspace ডকুমেন্টের জন্য Open URL ম্যানেজ করুন নিবন্ধটি দেখুন। Google Workspace ডকুমেন্ট এবং MIME টাইপ কনভার্সন ফর্ম্যাটের তালিকার জন্য, Google Workspace ডকুমেন্টের জন্য MIME টাইপ এক্সপোর্ট করুন দেখুন।

অ্যাপ-নির্দিষ্ট ডকুমেন্টের জন্য একটি খোলা URL ম্যানেজ করুন

Drive UI ইন্টিগ্রেশন কনফিগার করুন লিঙ্কে যেমন উল্লেখ করা আছে, আপনার অ্যাপ ফাইল খোলার জন্য প্রয়োজনীয় তথ্য সহ টেমপ্লেট ভেরিয়েবল পায়। আপনার অ্যাপ state প্যারামিটারের মধ্যে টেমপ্লেট ভেরিয়েবলের ডিফল্ট সেট পায়। অ্যাপ-নির্দিষ্ট URL খোলার জন্য ডিফল্ট state তথ্য হল:

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

এই আউটপুটে নিম্নলিখিত ভ্যালু অন্তর্ভুক্ত থাকে:

  • ID: পেরেন্ট ফোল্ডারের আইডি।
  • RESOURCE_KEYS: ফাইল আইডির JSON ডিকশনারি যা সংশ্লিষ্ট রিসোর্স কীতে ম্যাপ করা আছে।
  • open: যে অ্যাকশন পারফর্ম করা হচ্ছে। Open URL ব্যবহার করার সময় ভ্যালু হল open।
  • USER_ID: প্রোফাইল আইডি যা ব্যবহারকারীকে অনন্যভাবে শনাক্ত করে।

আপনার অ্যাপকে এইসব ধাপ অনুসরণ করে এই অনুরোধের উপর কাজ করতে হবে:

  1. action ফিল্ডে open ভ্যালু আছে কিনা এবং ids ফিল্ড আছে কিনা তা যাচাই করুন।
  2. ব্যবহারকারীর জন্য নতুন সেশন তৈরি করতে userId ভ্যালু ব্যবহার করুন। সাইন-ইন করা ব্যবহারকারীদের সম্পর্কে আরও জানতে, ব্যবহারকারী ও নতুন ইভেন্ট দেখুন।
  3. ID ভ্যালু ব্যবহার করে অনুমতি চেক করতে, ফাইল মেটাডেটা ফেচ করতে এবং ফাইলের কন্টেন্ট ডাউনলোড করতে files.get পদ্ধতি ব্যবহার করুন।
  4. অনুরোধে resourceKeys সেট করা থাকলে, X-Goog-Drive-Resource-Keys অনুরোধ হেডার সেট করুন। রিসোর্স কী সম্পর্কে আরও জানতে, রিসোর্স কী ব্যবহার করে লিঙ্ক-শেয়ার করা ফাইল অ্যাক্সেস করুন নিবন্ধটি দেখুন।

state প্যারামিটারটি URL-এনকোড করা, তাই আপনার অ্যাপকে অবশ্যই এস্কেপ ক্যারেক্টার ম্যানেজ করতে হবে এবং JSON হিসেবে পার্স করতে হবে।

Google Workspace ডকুমেন্টের জন্য একটি ওপেন URL ম্যানেজ করুন

Drive UI ইন্টিগ্রেশন কনফিগার করুন বিভাগে যেমন উল্লেখ করা হয়েছে, আপনার অ্যাপ state প্যারামিটারের মধ্যে টেমপ্লেট ভেরিয়েবলের ডিফল্ট সেট পায়। Google Workspace Open URL-এর জন্য ডিফল্ট state তথ্য হল:

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

এই আউটপুটে নিম্নলিখিত ভ্যালু অন্তর্ভুক্ত থাকে:

  • EXPORT_ID: এক্সপোর্ট করা হচ্ছে এমন ফাইল আইডির কমা দ্বারা আলাদা করা তালিকা। শুধুমাত্র Google Workspace ফাইল খোলার সময় ব্যবহার করা হয়।
  • RESOURCE_KEYS: ফাইল আইডির JSON ডিকশনারি যা সংশ্লিষ্ট রিসোর্স কীতে ম্যাপ করা আছে।
  • open: যে অ্যাকশন পারফর্ম করা হচ্ছে। Open URL ব্যবহার করার সময় ভ্যালু হল open।
  • USER_ID: প্রোফাইল আইডি যা ব্যবহারকারীকে শনাক্ত করে।

আপনার অ্যাপকে এইসব ধাপ অনুসরণ করে এই অনুরোধের উপর কাজ করতে হবে:

  1. state ফিল্ডে open ভ্যালু এবং exportIds ফিল্ডের উপস্থিতি শনাক্ত করে যাচাই করুন যে এটি ফাইল খোলার অনুরোধ কিনা।

  2. EXPORT_ID ভ্যালু ব্যবহার করে অনুমতি চেক করতে, ফাইল মেটাডেটা ফেচ করতে এবং MIME-এর ধরন নির্ধারণ করতে files.get পদ্ধতি ব্যবহার করুন।

  3. files.export পদ্ধতি ব্যবহার করে ফাইলের কন্টেন্ট কনভার্ট করুন। নিম্নলিখিত কোড স্যাম্পেল দেখায় যে কীভাবে অনুরোধ করা MIME-এর প্রকার অনুযায়ী Google Workspace ডকুমেন্ট এক্সপোর্ট করতে হয়।

  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
    import {GoogleAuth} from 'google-auth-library';
    import {google} from 'googleapis';
    
    /**
     * Exports a Google Doc as a PDF.
     * @param {string} fileId The ID of the file to export.
     * @return {Promise<number>} The status of the export request.
     */
    async function exportPdf(fileId) {
      // 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});
    
      // Export the file as a PDF.
      const result = await service.files.export({
        fileId,
        mimeType: 'application/pdf',
      });
    
      // Print the status of the export.
      console.log(result.status);
      return result.status;
    }

    PHP

    drive/snippets/drive_v3/src/DriveExportPdf.php
    <?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 প্যারামিটারটি URL-এনকোড করা, তাই আপনার অ্যাপকে অবশ্যই এস্কেপ ক্যারেক্টার ম্যানেজ করতে হবে এবং JSON হিসেবে পার্স করতে হবে।

ব্যবহারকারী ও নতুন ইভেন্ট

Drive অ্যাপের সব "এর মাধ্যমে খুলুন" ইভেন্টকে সম্ভাব্য সাইন-ইন হিসেবে বিবেচনা করা উচিত। কিছু ব্যবহারকারীর একাধিক অ্যাকাউন্ট থাকতে পারে, তাই state প্যারামিটারে ব্যবহারকারীর আইডি বর্তমান সেশনের সাথে নাও মিলতে পারে। state প্যারামিটারে ব্যবহারকারীর আইডি বর্তমান সেশনের সাথে ম্যাচ না করলে, আপনার অ্যাপের জন্য বর্তমান সেশন শেষ করুন এবং অনুরোধ করা ব্যবহারকারী হিসেবে সাইন-ইন করুন।

Google Drive UI থেকে কোনও অ্যাপ্লিকেশন খোলার পাশাপাশি, অ্যাপ্লিকেশনগুলি কোনও অ্যাপের মধ্যে থেকে কন্টেন্ট বেছে নেওয়ার জন্য ফাইল পিকার দেখাতে পারে। আরও তথ্যের জন্য, Google Picker দেখুন।