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 أو قبوله

نص الاستجابة

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

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

يتطلب أحد نطاقات 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 رفض المستخدم الاقتراح