Method: accessproposals.resolve

تُستخدَم للموافقة على اقتراح الوصول أو رفضه.

طلب HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals/{proposalId}:resolve

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
fileId

string

مطلوب. معرّف العنصر الذي يرتبط به الطلب

proposalId

string

مطلوب. رقم تعريف اقتراح الوصول المطلوب حلّه.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{
  "role": [
    string
  ],
  "view": string,
  "action": enum (Action),
  "sendNotification": boolean
}
الحقول
role[]

string

اختياريّ. الأدوار التي سمح بها المُوافق، إن توفّرت ملاحظة: هذا الحقل مطلوب لإجراء ACCEPT.

view

string

اختياريّ. تشير هذه السمة إلى طريقة عرض اقتراح الوصول هذا. يجب ضبط هذا الخيار فقط عندما ينتمي الاقتراح إلى عرض. published هي القيمة الوحيدة المسموح بها.

action

enum (Action)

مطلوب. الإجراء الذي يجب اتّخاذه بشأن AccessProposal

sendNotification

boolean

اختياريّ. ما إذا كان سيتم إرسال رسالة إلكترونية إلى مقدّم الطلب عند رفض AccessProposal أو قبوله.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

تكون بعض النطاقات محظورة وتتطلّب تقييم أمان ليتمكّن تطبيقك من استخدامها. لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

الإجراء

تغيير حالة AccessProposal

عمليات التعداد
ACTION_UNSPECIFIED إجراء غير محدّد
ACCEPT يقبل المستخدم الاقتراح. ملاحظة: في حال استخدام هذا الإجراء، يجب أن يحتوي الحقل role على قيمة واحدة على الأقل.
DENY يرفض المستخدم الاقتراح