@@ -196,7 +196,9 @@ export class Files extends APIResource {
196196 */
197197export interface File {
198198 /**
199- * An array of tags assigned to the file by auto tagging.
199+ * Array of `AITags` associated with the image. If no `AITags` are set, it will be
200+ * null. These tags can be added using the `google-auto-tagging` or
201+ * `aws-auto-tagging` extensions.
200202 */
201203 AITags ?: Array < File . AITag > | null ;
202204
@@ -222,7 +224,11 @@ export interface File {
222224 customCoordinates ?: string | null ;
223225
224226 /**
225- * An object with custom metadata for the file.
227+ * A key-value data associated with the asset. Use `responseField` in API request
228+ * to get `customMetadata` in the upload API response. Before setting any custom
229+ * metadata on an asset, you have to create the field using custom metadata fields
230+ * API. Send `customMetadata` in `responseFields` in API request to get the value
231+ * of this field.
226232 */
227233 customMetadata ?: { [ key : string ] : unknown } ;
228234
@@ -239,7 +245,8 @@ export interface File {
239245
240246 /**
241247 * Consolidated embedded metadata associated with the file. It includes exif, iptc,
242- * and xmp data.
248+ * and xmp data. Send `embeddedMetadata` in `responseFields` in API request to get
249+ * embeddedMetadata in the upload API response.
243250 */
244251 embeddedMetadata ?: { [ key : string ] : unknown } ;
245252
@@ -336,7 +343,7 @@ export interface File {
336343 url ?: string ;
337344
338345 /**
339- * An object with details of the file version.
346+ * An object containing the file or file version's `id` (versionId) and `name` .
340347 */
341348 versionInfo ?: File . VersionInfo ;
342349
@@ -431,7 +438,7 @@ export namespace File {
431438 }
432439
433440 /**
434- * An object with details of the file version.
441+ * An object containing the file or file version's `id` (versionId) and `name` .
435442 */
436443 export interface VersionInfo {
437444 /**
@@ -835,7 +842,9 @@ export interface FileRenameResponse {
835842 */
836843export interface FileUploadResponse {
837844 /**
838- * An array of tags assigned to the uploaded file by auto tagging.
845+ * Array of `AITags` associated with the image. If no `AITags` are set, it will be
846+ * null. These tags can be added using the `google-auto-tagging` or
847+ * `aws-auto-tagging` extensions.
839848 */
840849 AITags ?: Array < FileUploadResponse . AITag > | null ;
841850
@@ -1006,9 +1015,8 @@ export namespace FileUploadResponse {
10061015 name ?: string ;
10071016
10081017 /**
1009- * Array of `AITags` associated with the image. If no `AITags` are set, it will be
1010- * null. These tags can be added using the `google-auto-tagging` or
1011- * `aws-auto-tagging` extensions.
1018+ * Source of the tag. Possible values are `google-auto-tagging` and
1019+ * `aws-auto-tagging`.
10121020 */
10131021 source ?: string ;
10141022 }
0 commit comments