الاشتراك في أحداث Google Drive

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

لمزيد من المعلومات عن تطوير تطبيقات لـ Drive، يُرجى الاطّلاع على نظرة عامة على Google Drive API.

أحداث Drive المتوافقة

تتيح لك اشتراكات Google Workspace تلقّي أحداث حول أنواع التغييرات التالية في Drive:

• الملف هو:
  • تمت إضافته إلى مجلد أو مساحة تخزين سحابي مشتركة.
  • تم نقله إلى مجلد أو مساحة تخزين سحابي مشتركة.
  • تم تحميل نسخة معدّلة أو جديدة.
  • تم نقلها إلى المهملات أو إزالتها منها.
• تم إنشاء اقتراح وصول أو تمت الاستجابة إليه في ملف.

الموارد التي يمكنك مراقبة الأحداث فيها

لتلقّي الأحداث، عليك تحديد مورد Drive تريد تتبُّعه، ويُطلق عليه اسم المورد المستهدف للاشتراك.

تتيح واجهة برمجة التطبيقات Google Workspace Events API استخدام موارد الاستهداف التالية في Drive:

أنواع الأحداث لإنشاء الاشتراكات

عند إنشاء اشتراك في أحد موارد Drive، يمكنك استخدام الحقل eventTypes[] لتحديد أنواع الأحداث التي تريد تلقّيها. يتم تنسيق أنواع الأحداث وفقًا لمواصفات CloudEvents، مثل google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

على سبيل المثال، لتلقّي أحداث حول إنشاء ملف في مجلد أو مساحة تخزين سحابي مشتركة، عليك تحديد الملف كمورد مستهدف، ونوع الحدث كـ google.workspace.drive.file.v3.created. لتلقّي أحداث حول إنشاء اقتراح بشأن منح إذن الوصول إلى ملف، عليك تحديد اقتراح منح إذن الوصول كمورد مستهدف، ونوع الحدث على أنّه google.workspace.drive.accessproposal.v3.created. لمزيد من المعلومات حول طريقة عمل الأحداث، يمكنك الاطّلاع على بنية أحداث Google Workspace.

يعرض الجدول التالي أنواع الأحداث المتاحة للاشتراك في موارد Drive:

بيانات الأحداث

يوضّح هذا القسم بيانات الأحداث وأمثلة على حمولات الأحداث في Drive.

عندما يتلقّى اشتراك Google Workspace حدثًا من Drive، يحتوي الحقل data على حمولة الحدث. تحتوي حمولة البيانات هذه على معلومات حول مرجع Google Workspace الذي تم تغييره. على سبيل المثال، إذا اشتركت في أحداث الملفات، سيحتوي حمولة هذه الأحداث على معلومات حول مورد file الذي تم تغييره.

بيانات الموارد في حمولة الحدث

عند إنشاء اشتراك، يمكنك تحديد ما إذا كنت تريد أن تتضمّن الحمولة تفاصيل حول المورد أو اسم المورد فقط. على سبيل المثال، إذا كنت تريد تلقّي أحداث حول الملفات في Drive، يمكنك تحديد الحقول التي تريد تلقّيها من مورد files في حمولة الحدث.

يقدّم الجدول التالي أمثلة على حمولات JSON للاشتراك في مورد Drive. يحتوي معرّف الملف على أحرف وأرقام وبعض الرموز الخاصة منظَّمة على النحو التالي: files/^[01][0-9a-zA-Z_-]+$/. على سبيل المثال، files/1aaabbbAAABBB111222-_. بالنسبة إلى كل حدث تتلقّاه الاشتراك، يظهر الحمولة في الحقل data الخاص بالحدث:

{
  "fileCreatedEvent": {
    "file": {
      "id": "FILE_ID",
      "parent": "PARENT_ID",
      "version": "63",
      "mimeType": "application/vnd.google-apps.document"
    }
  }
}
      

{
  "fileCreatedEvent": {
    "file": {
      "id": "FILE_ID"
    }
  }
}
      

{
  "fileMovedEvent": {
    "file": {
      "id": "FILE_ID",
      "parent": "PARENT_ID",
      "version": "63",
      "mimeType": "application/vnd.google-apps.document"
    }
  }
}
      

{
  "fileMovedEvent": {
    "file": {
      "id": "FILE_ID"
    }
  }
}
      

{
  "fileContentChangedEvent": {
    "file": {
      "id": "FILE_ID",
      "parent": "PARENT_ID",
      "version": "63",
      "mimeType": "application/vnd.google-apps.document"
    }
  }
}
      

{
  "fileContentChangedEvent": {
    "file": {
      "id": "FILE_ID"
    }
  }
}
      

{
  "fileDeletedEvent": {
    "file": {
      "id": "FILE_ID",
      "parent": "PARENT_ID",
      "version": "63",
      "mimeType": "application/vnd.google-apps.document"
    }
  }
}
      

{
  "fileDeletedEvent": {
    "file": {
      "id": "FILE_ID"
    }
  }
}
      

{
  "fileTrashedEvent": {
    "file": {
      "id": "FILE_ID",
      "parent": "PARENT_ID",
      "version": "63",
      "mimeType": "application/vnd.google-apps.document"
    }
  }
}
      

{
  "fileTrashedEvent": {
    "file": {
      "id": "FILE_ID"
    }
  }
}
      

{
  "fileUntrashedEvent": {
    "file": {
      "id": "FILE_ID",
      "parent": "PARENT_ID",
      "version": "63",
      "mimeType": "application/vnd.google-apps.document"
    }
  }
}
      

{
  "fileUntrashedEvent": {
    "file": {
      "id": "FILE_ID"
    }
  }
}
      

{
  "accessProposalCreatedEvent": {
    "accessProposal": [
      {
        "file_id": "FILE_ID",
        "proposalId": "PROPOSAL_ID",
        "recipientEmailAddress": "63",
        "requesterEmailAddress": "application/vnd.google-apps.document",
        "requestMessage": "grant me access to this file",
        "rolesAndViews": [
          {
            "role": "writer",
            "view": "published"
          }
        ]
      }
    ]
  }
}
      

{
  "accessProposalCreatedEvent": {
    "accessProposal": [
      {
        "proposalId": "PROPOSAL_ID"
      }
    ]
  }
}
      

{
  "accessProposalResolvedEvent": {
    "accessProposal": [
      {
        "file_id": "FILE_ID",
        "proposalId": "PROPOSAL_ID",
        "recipientEmailAddress": "63",
        "requesterEmailAddress": "application/vnd.google-apps.document",
        "requestMessage": "resolve access to this file",
        "rolesAndViews": [
          {
            "role": "writer",
            "view": "published"
          }
        ]
      }
    ]
  }
}
      

{
  "accessProposalResolvedEvent": {
    "accessProposal": [
      {
        "proposalId": "PROPOSAL_ID"
      }
    ]
  }
}
      

• عندما تكون قيمة الحقل المنطقي includeDescendants في DriveOptions هي true، ترسل اشتراكات Drive في مساحات التخزين السحابي المشتركة والمجلدات حدثًا دائمًا، حتى إذا كان الملف الذي أدى إلى تشغيل الحدث مضمّنًا في عدة طبقات أسفل المجلد المستخدَم للاشتراك في Drive.
• على الرغم من أنّك قد تكون أنشأت اشتراكًا في مجلد، قد لا تتلقّى جميع الأحداث ضمن التسلسل الهرمي للملفات لأنّه قد لا يتم منح المستخدم أو التطبيق إذن الوصول إليها. في هذه الحالة، يظل الاشتراك نشطًا ولكن لن تتلقّى أي أحداث للموارد التي لا يمكنك الوصول إليها.
• تتوفّر الاشتراكات للأحداث على جميع الملفات والمجلدات، ولكن ليس على المجلد الجذر لمساحات التخزين السحابي المشتركة. لا تتوفّر الاشتراكات إلا للملفات والمجلدات داخل مساحات التخزين السحابي المشتركة. لن تؤدي التغييرات التي يتم إجراؤها مباشرةً على المجلد الجذر في مساحات التخزين السحابي المشتركة إلى تشغيل الأحداث.
• يجب أن يكون لدى المستخدم الذي يمنح الإذن بالاشتراك إذن بالملف الذي يتضمّن الأحداث التي يريد الاشتراك فيها.
• لا يتلقّى الاشتراك سوى أحداث الموارد التي يمكن للمستخدم الوصول إليها من خلال حساب Google Workspace أو حساب Google.

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

• نظرة عامة على Google Workspace Events API
• بنية أحداث Google Workspace
• اختيار نطاقات Google Workspace Events API
• اختيار نطاقات Google Drive API