Skip to content

Commit f68c70c

Browse files
yoshi-automationyoshi-automation
committed
feat(admin): update the API
#### admin:datatransfer_v1 The following keys were changed: - documentationLink #### admin:directory_v1 The following keys were changed: - documentationLink - resources.customers.resources.chrome.resources.printServers.methods.patch.parameters.name.description - resources.customers.resources.chrome.resources.printers.methods.patch.parameters.name.description - schemas.PrintServer.properties.name.description - schemas.Printer.properties.name.description #### admin:reports_v1 The following keys were added: - schemas.Activity.properties.actor.properties.applicationInfo.description - schemas.Activity.properties.actor.properties.applicationInfo.properties.applicationName.description - schemas.Activity.properties.actor.properties.applicationInfo.properties.applicationName.type - schemas.Activity.properties.actor.properties.applicationInfo.properties.impersonation.description - schemas.Activity.properties.actor.properties.applicationInfo.properties.impersonation.type - schemas.Activity.properties.actor.properties.applicationInfo.properties.oauthClientId.description - schemas.Activity.properties.actor.properties.applicationInfo.properties.oauthClientId.type - schemas.Activity.properties.actor.properties.applicationInfo.type - schemas.Activity.properties.events.items.properties.resourceIds.description - schemas.Activity.properties.events.items.properties.resourceIds.items.type - schemas.Activity.properties.events.items.properties.resourceIds.type - schemas.Activity.properties.resourceDetails.description - schemas.Activity.properties.resourceDetails.items.$ref - schemas.Activity.properties.resourceDetails.type - schemas.AppliedLabel.description - schemas.AppliedLabel.id - schemas.AppliedLabel.properties.fieldValues.description - schemas.AppliedLabel.properties.fieldValues.items.$ref - schemas.AppliedLabel.properties.fieldValues.type - schemas.AppliedLabel.properties.id.description - schemas.AppliedLabel.properties.id.type - schemas.AppliedLabel.properties.reason.$ref - schemas.AppliedLabel.properties.reason.description - schemas.AppliedLabel.properties.title.description - schemas.AppliedLabel.properties.title.type - schemas.AppliedLabel.type - schemas.Date.description - schemas.Date.id - schemas.Date.properties.day.description - schemas.Date.properties.day.format - schemas.Date.properties.day.type - schemas.Date.properties.month.description - schemas.Date.properties.month.format - schemas.Date.properties.month.type - schemas.Date.properties.year.description - schemas.Date.properties.year.format - schemas.Date.properties.year.type - schemas.Date.type - schemas.FieldValue.description - schemas.FieldValue.id - schemas.FieldValue.properties.dateValue.$ref - schemas.FieldValue.properties.dateValue.description - schemas.FieldValue.properties.displayName.description - schemas.FieldValue.properties.displayName.type - schemas.FieldValue.properties.id.description - schemas.FieldValue.properties.id.type - schemas.FieldValue.properties.integerValue.description - schemas.FieldValue.properties.integerValue.format - schemas.FieldValue.properties.integerValue.type - schemas.FieldValue.properties.longTextValue.description - schemas.FieldValue.properties.longTextValue.type - schemas.FieldValue.properties.reason.$ref - schemas.FieldValue.properties.reason.description - schemas.FieldValue.properties.selectionListValue.$ref - schemas.FieldValue.properties.selectionListValue.description - schemas.FieldValue.properties.selectionValue.$ref - schemas.FieldValue.properties.selectionValue.description - schemas.FieldValue.properties.textListValue.$ref - schemas.FieldValue.properties.textListValue.description - schemas.FieldValue.properties.textValue.description - schemas.FieldValue.properties.textValue.type - schemas.FieldValue.properties.type.description - schemas.FieldValue.properties.type.type - schemas.FieldValue.properties.unsetValue.description - schemas.FieldValue.properties.unsetValue.type - schemas.FieldValue.properties.userListValue.$ref - schemas.FieldValue.properties.userListValue.description - schemas.FieldValue.properties.userValue.$ref - schemas.FieldValue.properties.userValue.description - schemas.FieldValue.type - schemas.FieldValueSelectionListValue.description - schemas.FieldValueSelectionListValue.id - schemas.FieldValueSelectionListValue.properties.values.description - schemas.FieldValueSelectionListValue.properties.values.items.$ref - schemas.FieldValueSelectionListValue.properties.values.type - schemas.FieldValueSelectionListValue.type - schemas.FieldValueSelectionValue.description - schemas.FieldValueSelectionValue.id - schemas.FieldValueSelectionValue.properties.badged.description - schemas.FieldValueSelectionValue.properties.badged.type - schemas.FieldValueSelectionValue.properties.displayName.description - schemas.FieldValueSelectionValue.properties.displayName.type - schemas.FieldValueSelectionValue.properties.id.description - schemas.FieldValueSelectionValue.properties.id.type - schemas.FieldValueSelectionValue.type - schemas.FieldValueTextListValue.description - schemas.FieldValueTextListValue.id - schemas.FieldValueTextListValue.properties.values.description - schemas.FieldValueTextListValue.properties.values.items.type - schemas.FieldValueTextListValue.properties.values.type - schemas.FieldValueTextListValue.type - schemas.FieldValueUserListValue.description - schemas.FieldValueUserListValue.id - schemas.FieldValueUserListValue.properties.values.description - schemas.FieldValueUserListValue.properties.values.items.$ref - schemas.FieldValueUserListValue.properties.values.type - schemas.FieldValueUserListValue.type - schemas.FieldValueUserValue.description - schemas.FieldValueUserValue.id - schemas.FieldValueUserValue.properties.email.description - schemas.FieldValueUserValue.properties.email.type - schemas.FieldValueUserValue.type - schemas.Reason.description - schemas.Reason.id - schemas.Reason.properties.reasonType.description - schemas.Reason.properties.reasonType.type - schemas.Reason.type - schemas.ResourceDetails.description - schemas.ResourceDetails.id - schemas.ResourceDetails.properties.appliedLabels.description - schemas.ResourceDetails.properties.appliedLabels.items.$ref - schemas.ResourceDetails.properties.appliedLabels.type - schemas.ResourceDetails.properties.id.description - schemas.ResourceDetails.properties.id.type - schemas.ResourceDetails.properties.relation.description - schemas.ResourceDetails.properties.relation.type - schemas.ResourceDetails.properties.title.description - schemas.ResourceDetails.properties.title.type - schemas.ResourceDetails.properties.type.description - schemas.ResourceDetails.properties.type.type - schemas.ResourceDetails.type The following keys were changed: - documentationLink
1 parent 7b6cc3f commit f68c70c

File tree

5 files changed

+467
-14
lines changed

5 files changed

+467
-14
lines changed

‎discovery/admin-datatransfer_v1.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717
"canonicalName": "DataTransfer",
1818
"description": "Admin SDK lets administrators of enterprise domains to view and manage resources like user, groups etc. It also provides audit and usage reports of domain.",
1919
"discoveryVersion": "v1",
20-
"documentationLink": "https://developers.google.com/admin-sdk/",
20+
"documentationLink": "https://developers.google.com/workspace/admin/",
2121
"fullyEncodeReservedExpansion": true,
2222
"icons": {
2323
"x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -272,7 +272,7 @@
272272
}
273273
}
274274
},
275-
"revision": "20221205",
275+
"revision": "20250421",
276276
"rootUrl": "https://admin.googleapis.com/",
277277
"schemas": {
278278
"Application": {

‎discovery/admin-directory_v1.json

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@
9898
"canonicalName": "directory",
9999
"description": "Admin SDK lets administrators of enterprise domains to view and manage resources like user, groups etc. It also provides audit and usage reports of domain.",
100100
"discoveryVersion": "v1",
101-
"documentationLink": "https://developers.google.com/admin-sdk/",
101+
"documentationLink": "https://developers.google.com/workspace/admin/",
102102
"fullyEncodeReservedExpansion": true,
103103
"icons": {
104104
"x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -1011,7 +1011,7 @@
10111011
],
10121012
"parameters": {
10131013
"name": {
1014-
"description": "Immutable. Resource name of the print server. Leave empty when creating. Format: `customers/{customer.id}/printServers/{print_server.id}`",
1014+
"description": "Identifier. Resource name of the print server. Leave empty when creating. Format: `customers/{customer.id}/printServers/{print_server.id}`",
10151015
"location": "path",
10161016
"pattern": "^customers/[^/]+/chrome/printServers/[^/]+$",
10171017
"required": true,
@@ -1284,7 +1284,7 @@
12841284
"type": "string"
12851285
},
12861286
"name": {
1287-
"description": "The resource name of the Printer object, in the format customers/{customer-id}/printers/{printer-id} (During printer creation leave empty)",
1287+
"description": "Identifier. The resource name of the Printer object, in the format customers/{customer-id}/printers/{printer-id} (During printer creation leave empty)",
12881288
"location": "path",
12891289
"pattern": "^customers/[^/]+/chrome/printers/[^/]+$",
12901290
"required": true,
@@ -4671,7 +4671,7 @@
46714671
}
46724672
}
46734673
},
4674-
"revision": "20250217",
4674+
"revision": "20250421",
46754675
"rootUrl": "https://admin.googleapis.com/",
46764676
"schemas": {
46774677
"Alias": {
@@ -7202,7 +7202,7 @@
72027202
"type": "string"
72037203
},
72047204
"name": {
7205-
"description": "Immutable. Resource name of the print server. Leave empty when creating. Format: `customers/{customer.id}/printServers/{print_server.id}`",
7205+
"description": "Identifier. Resource name of the print server. Leave empty when creating. Format: `customers/{customer.id}/printServers/{print_server.id}`",
72067206
"type": "string"
72077207
},
72087208
"orgUnitId": {
@@ -7312,7 +7312,7 @@
73127312
"type": "string"
73137313
},
73147314
"name": {
7315-
"description": "The resource name of the Printer object, in the format customers/{customer-id}/printers/{printer-id} (During printer creation leave empty)",
7315+
"description": "Identifier. The resource name of the Printer object, in the format customers/{customer-id}/printers/{printer-id} (During printer creation leave empty)",
73167316
"type": "string"
73177317
},
73187318
"orgUnitId": {

‎discovery/admin-reports_v1.json

Lines changed: 259 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717
"canonicalName": "reports",
1818
"description": "Admin SDK lets administrators of enterprise domains to view and manage resources like user, groups etc. It also provides audit and usage reports of domain.",
1919
"discoveryVersion": "v1",
20-
"documentationLink": "https://developers.google.com/admin-sdk/",
20+
"documentationLink": "https://developers.google.com/workspace/admin/",
2121
"fullyEncodeReservedExpansion": true,
2222
"icons": {
2323
"x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -626,7 +626,7 @@
626626
}
627627
}
628628
},
629-
"revision": "20250304",
629+
"revision": "20250424",
630630
"rootUrl": "https://admin.googleapis.com/",
631631
"schemas": {
632632
"Activities": {
@@ -663,6 +663,24 @@
663663
"actor": {
664664
"description": "User doing the action.",
665665
"properties": {
666+
"applicationInfo": {
667+
"description": "Details of the application that was the actor for the activity.",
668+
"properties": {
669+
"applicationName": {
670+
"description": "Name of the application used to perform the action.",
671+
"type": "string"
672+
},
673+
"impersonation": {
674+
"description": "Whether the application was impersonating a user.",
675+
"type": "boolean"
676+
},
677+
"oauthClientId": {
678+
"description": "OAuth client id of the third party application used to perform the action.",
679+
"type": "string"
680+
}
681+
},
682+
"type": "object"
683+
},
666684
"callerType": {
667685
"description": "The type of actor.",
668686
"type": "string"
@@ -764,6 +782,13 @@
764782
},
765783
"type": "array"
766784
},
785+
"resourceIds": {
786+
"description": "Resource ids associated with the event.",
787+
"items": {
788+
"type": "string"
789+
},
790+
"type": "array"
791+
},
767792
"type": {
768793
"description": "Type of event. The Google Workspace service or feature that an administrator changes is identified in the `type` property which identifies an event using the `eventName` property. For a full list of the API's `type` categories, see the list of event names for various applications above in `applicationName`.",
769794
"type": "string"
@@ -809,6 +834,39 @@
809834
"ownerDomain": {
810835
"description": "This is the domain that is affected by the report's event. For example domain of Admin console or the Drive application's document owner.",
811836
"type": "string"
837+
},
838+
"resourceDetails": {
839+
"description": "Details of the resource on which the action was performed.",
840+
"items": {
841+
"$ref": "ResourceDetails"
842+
},
843+
"type": "array"
844+
}
845+
},
846+
"type": "object"
847+
},
848+
"AppliedLabel": {
849+
"description": "Details of the label applied on the resource.",
850+
"id": "AppliedLabel",
851+
"properties": {
852+
"fieldValues": {
853+
"description": "List of fields which are part of the label and have been set by the user. If label has a field which was not set by the user, it would not be present in this list.",
854+
"items": {
855+
"$ref": "FieldValue"
856+
},
857+
"type": "array"
858+
},
859+
"id": {
860+
"description": "Identifier of the label - Only the label id, not the full OnePlatform resource name.",
861+
"type": "string"
862+
},
863+
"reason": {
864+
"$ref": "Reason",
865+
"description": "The reason why the label was applied on the resource."
866+
},
867+
"title": {
868+
"description": "Title of the label",
869+
"type": "string"
812870
}
813871
},
814872
"type": "object"
@@ -865,6 +923,164 @@
865923
},
866924
"type": "object"
867925
},
926+
"Date": {
927+
"description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp",
928+
"id": "Date",
929+
"properties": {
930+
"day": {
931+
"description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.",
932+
"format": "int32",
933+
"type": "integer"
934+
},
935+
"month": {
936+
"description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.",
937+
"format": "int32",
938+
"type": "integer"
939+
},
940+
"year": {
941+
"description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.",
942+
"format": "int32",
943+
"type": "integer"
944+
}
945+
},
946+
"type": "object"
947+
},
948+
"FieldValue": {
949+
"description": "Details of the field value set by the user for the particular label.",
950+
"id": "FieldValue",
951+
"properties": {
952+
"dateValue": {
953+
"$ref": "Date",
954+
"description": "Setting a date value."
955+
},
956+
"displayName": {
957+
"description": "Display name of the field",
958+
"type": "string"
959+
},
960+
"id": {
961+
"description": "Identifier of the field",
962+
"type": "string"
963+
},
964+
"integerValue": {
965+
"description": "Setting an integer value.",
966+
"format": "int64",
967+
"type": "string"
968+
},
969+
"longTextValue": {
970+
"description": "Setting a long text value.",
971+
"type": "string"
972+
},
973+
"reason": {
974+
"$ref": "Reason",
975+
"description": "The reason why the field was applied to the label."
976+
},
977+
"selectionListValue": {
978+
"$ref": "FieldValueSelectionListValue",
979+
"description": "Setting a selection list value by selecting multiple values from a dropdown."
980+
},
981+
"selectionValue": {
982+
"$ref": "FieldValueSelectionValue",
983+
"description": "Setting a selection value by selecting a single value from a dropdown."
984+
},
985+
"textListValue": {
986+
"$ref": "FieldValueTextListValue",
987+
"description": "Setting a text list value."
988+
},
989+
"textValue": {
990+
"description": "Setting a text value.",
991+
"type": "string"
992+
},
993+
"type": {
994+
"description": "Type of the field",
995+
"type": "string"
996+
},
997+
"unsetValue": {
998+
"description": "If the field is unset, this will be true.",
999+
"type": "boolean"
1000+
},
1001+
"userListValue": {
1002+
"$ref": "FieldValueUserListValue",
1003+
"description": "Setting a user list value by selecting multiple users."
1004+
},
1005+
"userValue": {
1006+
"$ref": "FieldValueUserValue",
1007+
"description": "Setting a user value by selecting a single user."
1008+
}
1009+
},
1010+
"type": "object"
1011+
},
1012+
"FieldValueSelectionListValue": {
1013+
"description": "Setting a selection list value by selecting multiple values from a dropdown.",
1014+
"id": "FieldValueSelectionListValue",
1015+
"properties": {
1016+
"values": {
1017+
"description": "List of selections.",
1018+
"items": {
1019+
"$ref": "FieldValueSelectionValue"
1020+
},
1021+
"type": "array"
1022+
}
1023+
},
1024+
"type": "object"
1025+
},
1026+
"FieldValueSelectionValue": {
1027+
"description": "Setting a selection value by selecting a single value from a dropdown.",
1028+
"id": "FieldValueSelectionValue",
1029+
"properties": {
1030+
"badged": {
1031+
"description": "Whether the selection is badged.",
1032+
"type": "boolean"
1033+
},
1034+
"displayName": {
1035+
"description": "Display name of the selection.",
1036+
"type": "string"
1037+
},
1038+
"id": {
1039+
"description": "Identifier of the selection.",
1040+
"type": "string"
1041+
}
1042+
},
1043+
"type": "object"
1044+
},
1045+
"FieldValueTextListValue": {
1046+
"description": "Setting a text list value.",
1047+
"id": "FieldValueTextListValue",
1048+
"properties": {
1049+
"values": {
1050+
"description": "List of text values.",
1051+
"items": {
1052+
"type": "string"
1053+
},
1054+
"type": "array"
1055+
}
1056+
},
1057+
"type": "object"
1058+
},
1059+
"FieldValueUserListValue": {
1060+
"description": "Setting a user list value by selecting multiple users.",
1061+
"id": "FieldValueUserListValue",
1062+
"properties": {
1063+
"values": {
1064+
"description": "List of users.",
1065+
"items": {
1066+
"$ref": "FieldValueUserValue"
1067+
},
1068+
"type": "array"
1069+
}
1070+
},
1071+
"type": "object"
1072+
},
1073+
"FieldValueUserValue": {
1074+
"description": "Setting a user value by selecting a single user.",
1075+
"id": "FieldValueUserValue",
1076+
"properties": {
1077+
"email": {
1078+
"description": "Email of the user.",
1079+
"type": "string"
1080+
}
1081+
},
1082+
"type": "object"
1083+
},
8681084
"NestedParameter": {
8691085
"description": "JSON template for a parameter used in various reports.",
8701086
"id": "NestedParameter",
@@ -911,6 +1127,47 @@
9111127
},
9121128
"type": "object"
9131129
},
1130+
"Reason": {
1131+
"description": "The reason why the label/field was applied.",
1132+
"id": "Reason",
1133+
"properties": {
1134+
"reasonType": {
1135+
"description": "The type of the reason.",
1136+
"type": "string"
1137+
}
1138+
},
1139+
"type": "object"
1140+
},
1141+
"ResourceDetails": {
1142+
"description": "Details of the resource on which the action was performed.",
1143+
"id": "ResourceDetails",
1144+
"properties": {
1145+
"appliedLabels": {
1146+
"description": "List of labels applied on the resource",
1147+
"items": {
1148+
"$ref": "AppliedLabel"
1149+
},
1150+
"type": "array"
1151+
},
1152+
"id": {
1153+
"description": "Identifier of the resource.",
1154+
"type": "string"
1155+
},
1156+
"relation": {
1157+
"description": "Defines relationship of the resource to the events",
1158+
"type": "string"
1159+
},
1160+
"title": {
1161+
"description": "Title of the resource. For instance, in case of a drive document, this would be the title of the document. In case of an email, this would be the subject.",
1162+
"type": "string"
1163+
},
1164+
"type": {
1165+
"description": "Type of the resource - document, email, chat message",
1166+
"type": "string"
1167+
}
1168+
},
1169+
"type": "object"
1170+
},
9141171
"UsageReport": {
9151172
"description": "JSON template for a usage report.",
9161173
"id": "UsageReport",

0 commit comments

Comments
 (0)