Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

الدمج مع واجهة مستخدم Drive "؛الفتح باستخدام" قائمة السياق

عندما يختار المستخدم ملفًا وينقر على عنصر القائمة فتح باستخدام في واجهة مستخدم Drive، يعيد Drive توجيه المستخدم إلى عنوان URL للفتح الخاص بهذا التطبيق والمحدّد في ضبط عملية دمج واجهة مستخدم Drive.

إذا تم وضع علامة في مربّع "الاستيراد" عند ضبط عملية دمج واجهة مستخدم Drive، يمكن للمستخدم اختيار مجموعة من الملفات الخاصة بالتطبيق وملفات Google Workspace لفتحها. عند ضبط عملية دمج واجهة مستخدم Drive، يتم تحديد الملفات الخاصة بالتطبيق في الحقلَين "أنواع MIME التلقائية" و"امتدادات الملفات التلقائية"، بينما يتم تحديد ملفات Google Workspace في الحقلَين "أنواع MIME الثانوية" و"امتدادات الملفات الثانوية".

لكل ملف يريد المستخدم فتحه، يتحقّق Drive من أنواع MIME مقارنةً بأنواع MIME التلقائية والثانوية المحدّدة:

بالنسبة إلى أنواع MIME المحدّدة في الحقل "أنواع MIME التلقائية"، يتم تمرير رقم تعريف الملف إلى تطبيقك. للتعرّف على كيفية التعامل مع الملفات الخاصة بالتطبيق ، يُرجى الاطّلاع على التعامل مع عنوان URL للفتح للمستندات الخاصة بالتطبيق.
بالنسبة إلى أنواع MIME المحدّدة في الحقل "أنواع MIME الثانوية"، تعرض واجهة مستخدم Drive مربّع حوار يطلب من المستخدم تحديد نوع الملف الذي سيتم تحويل ملف Google Workspace إليه. على سبيل المثال، إذا تم اختيار ملف "مستندات Google" في واجهة مستخدم Drive وكان الحقل "أنواع MIME الثانوية" يشير إلى أنّ تطبيقك يتيح استخدام text/plain أو application/pdf، ستسأل واجهة مستخدم Drive المستخدم عمّا إذا كان يريد التحويل إلى نص عادي أو PDF.

للتعرّف على كيفية التعامل مع ملفات Google Workspace ، يُرجى الاطّلاع على التعامل مع عنوان URL للفتح لمستندات Google Workspace. للاطّلاع على قائمة بمستندات Google Workspace وتنسيقات تحويل أنواع MIME، يُرجى الاطّلاع على تصدير أنواع MIME لمستندات Google Workspace .

التعامل مع عنوان URL للفتح للمستندات الخاصة بالتطبيق

كما هو موضّح في ضبط عملية دمج واجهة مستخدم Drive، يتلقّى تطبيقك متغيّرات نموذج تتضمّن معلومات لفتح الملف. يتلقّى تطبيقك مجموعة تلقائية من متغيّرات النموذج ضمن مَعلمة state. معلومات state التلقائية لعنوان URL للفتح الخاص بالتطبيق هي:

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

يتضمّن هذا الناتج القيم التالية:

ID: رقم تعريف المجلد الرئيسي.
RESOURCE_KEYS: قاموس JSON لأرقام تعريف الملفات التي تم ربطها بـ مفاتيح الموارد الخاصة بها.
open: الإجراء الذي يتم تنفيذه. تكون القيمة open عند استخدام عنوان URL للفتح.
USER_ID: رقم تعريف الملف الشخصي الذي يحدّد المستخدم بشكلٍ فريد.

يجب أن يتخذ تطبيقك إجراءً بشأن هذا الطلب باتّباع الخطوات التالية:

التأكّد من أنّ الحقل action يتضمّن القيمة open وأنّ الحقل ids متوفّر.
استخدام قيمة userId لإنشاء جلسة جديدة للمستخدم. لمزيد من المعلومات عن المستخدمين الذين سجّلوا الدخول، يُرجى الاطّلاع على المستخدمون والأحداث الجديدة.
استخدام طريقة files.get للتحقّق من الأذونات وجلب البيانات الوصفية للملف وتنزيل محتوى الملف باستخدام قيم ID.
إذا تم ضبط resourceKeys في الطلب، يجب ضبط عنوان طلب X-Goog-Drive-Resource-Keys. لمزيد من المعلومات عن مفاتيح الموارد، يُرجى الاطّلاع على الوصول إلى الملفات التي تمت مشاركتها باستخدام رابط من خلال مفاتيح الموارد.

إنّ المَعلمة state هي عنوان URL مشفّر، لذا يجب أن يتعامل تطبيقك مع أحرف الإلغاء ويحلّلها كملف JSON.

التعامل مع عنوان URL للفتح لمستندات Google Workspace

كما هو موضّح في ضبط عملية دمج واجهة مستخدم Drive ، يتلقّى تطبيقك مجموعة تلقائية من متغيّرات النموذج ضمن مَعلمة state. معلومات state التلقائية لعنوان URL للفتح في Google Workspace هي:

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

يتضمّن هذا الناتج القيم التالية:

EXPORT_ID: قائمة بأرقام تعريف الملفات التي يتم تصديرها، مفصولة بفواصل. لا يتم استخدامها إلا عند فتح ملفات Google Workspace.
RESOURCE_KEYS: قاموس JSON لأرقام تعريف الملفات التي تم ربطها بـ مفاتيح الموارد الخاصة بها.
open: الإجراء الذي يتم تنفيذه. تكون القيمة open عند استخدام عنوان URL للفتح.
USER_ID: رقم تعريف الملف الشخصي الذي يحدّد المستخدم.

يجب أن يتخذ تطبيقك إجراءً بشأن هذا الطلب باتّباع الخطوات التالية:

التأكّد من أنّ هذا الطلب يهدف إلى فتح ملف من خلال رصد كل من القيمة open في الحقل state وتوفّر الحقل exportIds.
استخدام طريقة files.get للتحقّق من الأذونات وجلب البيانات الوصفية للملف وتحديد نوع MIME باستخدام قيم EXPORT_ID.
تحويل محتوى الملف باستخدام طريقة files.export. يوضّح نموذج الرمز البرمجي التالي كيفية تصدير مستند Google Workspace إلى نوع MIME المطلوب.

إذا تم ضبط resourceKey في الطلب، يجب ضبط عنوان طلب X-Goog-Drive-Resource-Keys. لمزيد من المعلومات عن مفاتيح الموارد، يُرجى الاطّلاع على الوصول إلى الملفات التي تمت مشاركتها باستخدام رابط من خلال مفاتيح الموارد.

جافا

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

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

عرض على GitHub

<?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 مع الجلسة الحالية، يجب إنهاء الجلسة الحالية لتطبيقك وتسجيل الدخول بصفتك المستخدم المطلوب.

الدمج مع واجهة مستخدم Drive "؛الفتح باستخدام" قائمة السياق تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

التعامل مع عنوان URL للفتح للمستندات الخاصة بالتطبيق

التعامل مع عنوان URL للفتح لمستندات Google Workspace

جافا

Python

Node.js

PHP

المستخدمون والأحداث الجديدة

مواضيع ذات صلة

الدمج مع واجهة مستخدم Drive "؛الفتح باستخدام" قائمة السياق