REST Resource: accessproposals
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المورد: AccessProposal
تمثّل هذه السمة اقتراحات الوصول المعلقة إلى ملف.
| تمثيل JSON |
{
"fileId": string,
"proposalId": string,
"requesterEmailAddress": string,
"recipientEmailAddress": string,
"rolesAndViews": [
{
object (RoleAndView)
}
],
"requestMessage": string,
"createTime": string
} |
| الحقول |
fileId |
string
معرّف الملف الذي يتضمّن اقتراح الوصول
|
proposalId |
string
معرّف اقتراح الوصول
|
requesterEmailAddress |
string
عنوان البريد الإلكتروني للمستخدم الذي يقدّم الطلب
|
recipientEmailAddress |
string
عنوان البريد الإلكتروني للمستخدم الذي سيحصل على الأذونات في حال قبول الطلب
|
rolesAndViews[] |
object (RoleAndView)
حاوية للدور وطريقة عرض اقتراح الوصول
|
requestMessage |
string
الرسالة التي أضافها مقدّم الطلب إلى الاقتراح
|
createTime |
string (Timestamp format)
وقت الإنشاء يستخدم هذا النوع RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
|
RoleAndView
حاوية للدور وطريقة عرض اقتراح الوصول
| تمثيل JSON |
{
"role": string,
"view": string
} |
| الحقول |
role |
string
الدور الذي اقترحه مقدّم الطلب. قد تتم إضافة قيم جديدة في المستقبل، ولكن القيم التالية متاحة حاليًا: * writer * commenter * reader
|
view |
string
تشير هذه السمة إلى طريقة عرض اقتراح الوصول هذا. لا تتم تعبئة هذا الحقل إلا للعروض التي تنتمي إلى طريقة عرض. القيمة الوحيدة المسموح بها هي published.
|
الطُرق |
|
|
يستردّ هذا الإجراء AccessProposal حسب المعرّف. |
|
|
عرض قائمة بطلبات الوصول إلى ملف |
|
|
تُستخدَم للموافقة على "اقتراح الوصول" أو رفضه. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# REST Resource: accessproposals\n\n- [Resource: AccessProposal](#AccessProposal)\n - [JSON representation](#AccessProposal.SCHEMA_REPRESENTATION)\n- [RoleAndView](#RoleAndView)\n - [JSON representation](#RoleAndView.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AccessProposal\n------------------------\n\nThe Access Proposal resource for outstanding access proposals on a file\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"fileId\": string, \"proposalId\": string, \"requesterEmailAddress\": string, \"recipientEmailAddress\": string, \"rolesAndViews\": [ { object (/workspace/drive/api/reference/rest/v3/accessproposals#RoleAndView) } ], \"requestMessage\": string, \"createTime\": string } ``` |\n\n| Fields ||\n|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `fileId` | `string` The file id that the proposal for access is on |\n| `proposalId` | `string` The id of the access proposal |\n| `requesterEmailAddress` | `string` The email address of the requesting user |\n| `recipientEmailAddress` | `string` The email address of the user that will receive permissions if accepted |\n| `rolesAndViews[]` | `object (`[RoleAndView](/workspace/drive/api/reference/rest/v3/accessproposals#RoleAndView)`)` A wrapper for the role and view of an access proposal. |\n| `requestMessage` | `string` The message that the requester added to the proposal |\n| `createTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` The creation time Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n\nRoleAndView\n-----------\n\nA wrapper for the role and view of an access proposal.\n\n| JSON representation |\n|--------------------------------------------|\n| ``` { \"role\": string, \"view\": string } ``` |\n\n| Fields ||\n|--------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `role` | `string` The role that was proposed by the requester New values may be added in the future, but the following are currently possible: \\* `writer` \\* `commenter` \\* `reader` |\n| `view` | `string` Indicates the view for this access proposal. Only populated for proposals that belong to a view. `published` is the only supported value. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------|---------------------------------------------|\n| ### [get](/workspace/drive/api/reference/rest/v3/accessproposals/get) | Retrieves an AccessProposal by ID. |\n| ### [list](/workspace/drive/api/reference/rest/v3/accessproposals/list) | List the AccessProposals on a file. |\n| ### [resolve](/workspace/drive/api/reference/rest/v3/accessproposals/resolve) | Used to approve or deny an Access Proposal. |"]]
