Skip to content

Commit fd33a67

Browse files
authored
Google Drive source connector: now outputs permissions metadata (#591)
1 parent 0245f24 commit fd33a67

File tree

1 file changed

+66
-0
lines changed

1 file changed

+66
-0
lines changed

snippets/general-shared-text/google-drive.mdx

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,3 +37,69 @@ allowfullscreen
3737
[Learn how](https://support.google.com/drive/answer/7166529).
3838
[Learn more](https://www.googlecloudcommunity.com/gc/Workspace-Q-A/Can-i-give-access-to-document-of-google-drive-to-service-account/m-p/530106).
3939
- Get the shared folder's ID or shared drive's ID. This is a part of the URL for your Google Drive shared folder or shared drive, represented in the following URL as `{folder_id}`: `https://drive.google.com/drive/folders/{folder-id}`.
40+
41+
## Document permissions metadata
42+
43+
The source connector outputs any permissions information that it can find in the source location about the processed source documents and associates that information with each
44+
corresponding element that is generated. This permissions information is output into the `permissions_data` field, which is within the
45+
`data_source` field under the element's `metadata` field. This information lists the users or groups, if any, that have
46+
permissions to read, update, or delete the element's associated source document.
47+
48+
The following example shows what the output looks like. Ellipses indicate content that has been omitted from this example for brevity.
49+
50+
```json
51+
[
52+
{
53+
"...": "...",
54+
"metadata": {
55+
"...": "...",
56+
"data_source": {
57+
"...": "...",
58+
"permissions_data": [
59+
{
60+
"read": {
61+
"users": [
62+
"11111111111111111111"
63+
],
64+
"groups": [
65+
"22222222222222222222",
66+
"33333333333333333333"
67+
]
68+
}
69+
},
70+
{
71+
"update": {
72+
"users": [
73+
"44444444444444444444",
74+
"55555555555555555555"
75+
],
76+
"groups": [
77+
"66666666666666666666",
78+
]
79+
}
80+
},
81+
{
82+
"delete": {
83+
"users": [
84+
"77777777777777777777"
85+
],
86+
"groups": [
87+
"88888888888888888888"
88+
]
89+
}
90+
}
91+
],
92+
"...": "..."
93+
}
94+
}
95+
}
96+
]
97+
```
98+
99+
To look up information about a particular Google Cloud user, use the user's ID along with the
100+
[Admin SDK API](https://developers.google.com/workspace/admin/directory/reference/rest/v1/users/get) or the
101+
[People API](https://developers.google.com/people/api/rest/v1/people/get) for Google Cloud.
102+
103+
To look up information about a particular Google Cloud group, use the group's ID along with the
104+
[Admin SDK API](https://developers.google.com/workspace/admin/directory/reference/rest/v1/groups/get) or the
105+
[Cloud Identity API](https://cloud.google.com/identity/docs/reference/rest/v1/groups/get) for Google Cloud.

0 commit comments

Comments
 (0)