Reference documentation and code samples for the Google Cloud Ai Platform V1 Client class Annotation.
Used to assign specific AnnotationSpec to a particular area of a DataItem or
the whole part of the DataItem.
Generated from protobuf messagegoogle.cloud.aiplatform.v1.Annotation
Namespace
Google \ Cloud \ AIPlatform \ V1
Methods
__construct
Constructor.
Parameters
Name
Description
data
array
Optional. Data for populating the Message object.
↳ name
string
Output only. Resource name of the Annotation.
↳ payload_schema_uri
string
Required. Google Cloud Storage URI points to a YAML file describingpayload. The schema is defined as anOpenAPI 3.0.2 Schema Object. The schema files that can be used here are found in gs://google-cloud-aiplatform/schema/dataset/annotation/, note that the chosen schema must be consistent with the parent Dataset'smetadata.
Optional. The labels with user-defined metadata to organize your Annotations. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. No more than 64 user labels can be associated with one Annotation(System labels are excluded). Seehttps://goo.gl/xmQnxffor more information and examples of labels. System reserved label keys are prefixed with "aiplatform.googleapis.com/" and are immutable. Following system labels exist for each Annotation: * * "aiplatform.googleapis.com/annotation_set_name": optional, name of the UI's annotation set this Annotation belongs to. If not set, the Annotation is not visible in the UI. * * "aiplatform.googleapis.com/payload_schema": output only, its value is thepayload_schema'stitle.
The schema files that can be used here are found in
gs://google-cloud-aiplatform/schema/dataset/annotation/, note that the
chosen schema must be consistent with the parent Dataset'smetadata.
The schema files that can be used here are found in
gs://google-cloud-aiplatform/schema/dataset/annotation/, note that the
chosen schema must be consistent with the parent Dataset'smetadata.
Parameter
Name
Description
var
string
Returns
Type
Description
$this
getPayload
Required. The schema of the payload can be found inpayload_schema.
Optional. The labels with user-defined metadata to organize your
Annotations.
Label keys and values can be no longer than 64 characters
(Unicode codepoints), can only contain lowercase letters, numeric
characters, underscores and dashes. International characters are allowed.
No more than 64 user labels can be associated with one Annotation(System
labels are excluded).
Seehttps://goo.gl/xmQnxffor more information and examples of labels.
System reserved label keys are prefixed with "aiplatform.googleapis.com/"
and are immutable. Following system labels exist for each Annotation:
"aiplatform.googleapis.com/annotation_set_name":
optional, name of the UI's annotation set this Annotation belongs to.
If not set, the Annotation is not visible in the UI.
"aiplatform.googleapis.com/payload_schema":
output only, its value is thepayload_schema'stitle.
Optional. The labels with user-defined metadata to organize your
Annotations.
Label keys and values can be no longer than 64 characters
(Unicode codepoints), can only contain lowercase letters, numeric
characters, underscores and dashes. International characters are allowed.
No more than 64 user labels can be associated with one Annotation(System
labels are excluded).
Seehttps://goo.gl/xmQnxffor more information and examples of labels.
System reserved label keys are prefixed with "aiplatform.googleapis.com/"
and are immutable. Following system labels exist for each Annotation:
"aiplatform.googleapis.com/annotation_set_name":
optional, name of the UI's annotation set this Annotation belongs to.
If not set, the Annotation is not visible in the UI.
"aiplatform.googleapis.com/payload_schema":
output only, its value is thepayload_schema'stitle.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Google Cloud Ai Platform V1 Client - Class Annotation (1.35.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.35.0 (latest)](/php/docs/reference/cloud-ai-platform/latest/V1.Annotation)\n- [1.34.0](/php/docs/reference/cloud-ai-platform/1.34.0/V1.Annotation)\n- [1.33.0](/php/docs/reference/cloud-ai-platform/1.33.0/V1.Annotation)\n- [1.32.1](/php/docs/reference/cloud-ai-platform/1.32.1/V1.Annotation)\n- [1.31.0](/php/docs/reference/cloud-ai-platform/1.31.0/V1.Annotation)\n- [1.30.0](/php/docs/reference/cloud-ai-platform/1.30.0/V1.Annotation)\n- [1.26.0](/php/docs/reference/cloud-ai-platform/1.26.0/V1.Annotation)\n- [1.23.0](/php/docs/reference/cloud-ai-platform/1.23.0/V1.Annotation)\n- [1.22.0](/php/docs/reference/cloud-ai-platform/1.22.0/V1.Annotation)\n- [1.21.0](/php/docs/reference/cloud-ai-platform/1.21.0/V1.Annotation)\n- [1.20.0](/php/docs/reference/cloud-ai-platform/1.20.0/V1.Annotation)\n- [1.19.0](/php/docs/reference/cloud-ai-platform/1.19.0/V1.Annotation)\n- [1.18.0](/php/docs/reference/cloud-ai-platform/1.18.0/V1.Annotation)\n- [1.17.0](/php/docs/reference/cloud-ai-platform/1.17.0/V1.Annotation)\n- [1.16.0](/php/docs/reference/cloud-ai-platform/1.16.0/V1.Annotation)\n- [1.15.0](/php/docs/reference/cloud-ai-platform/1.15.0/V1.Annotation)\n- [1.14.0](/php/docs/reference/cloud-ai-platform/1.14.0/V1.Annotation)\n- [1.13.1](/php/docs/reference/cloud-ai-platform/1.13.1/V1.Annotation)\n- [1.12.0](/php/docs/reference/cloud-ai-platform/1.12.0/V1.Annotation)\n- [1.11.0](/php/docs/reference/cloud-ai-platform/1.11.0/V1.Annotation)\n- [1.10.0](/php/docs/reference/cloud-ai-platform/1.10.0/V1.Annotation)\n- [1.9.0](/php/docs/reference/cloud-ai-platform/1.9.0/V1.Annotation)\n- [1.8.0](/php/docs/reference/cloud-ai-platform/1.8.0/V1.Annotation)\n- [1.7.0](/php/docs/reference/cloud-ai-platform/1.7.0/V1.Annotation)\n- [1.6.0](/php/docs/reference/cloud-ai-platform/1.6.0/V1.Annotation)\n- [1.5.0](/php/docs/reference/cloud-ai-platform/1.5.0/V1.Annotation)\n- [1.4.0](/php/docs/reference/cloud-ai-platform/1.4.0/V1.Annotation)\n- [1.3.0](/php/docs/reference/cloud-ai-platform/1.3.0/V1.Annotation)\n- [1.2.0](/php/docs/reference/cloud-ai-platform/1.2.0/V1.Annotation)\n- [1.1.0](/php/docs/reference/cloud-ai-platform/1.1.0/V1.Annotation)\n- [1.0.0](/php/docs/reference/cloud-ai-platform/1.0.0/V1.Annotation)\n- [0.39.0](/php/docs/reference/cloud-ai-platform/0.39.0/V1.Annotation)\n- [0.38.0](/php/docs/reference/cloud-ai-platform/0.38.0/V1.Annotation)\n- [0.37.1](/php/docs/reference/cloud-ai-platform/0.37.1/V1.Annotation)\n- [0.32.0](/php/docs/reference/cloud-ai-platform/0.32.0/V1.Annotation)\n- [0.31.0](/php/docs/reference/cloud-ai-platform/0.31.0/V1.Annotation)\n- [0.30.0](/php/docs/reference/cloud-ai-platform/0.30.0/V1.Annotation)\n- [0.29.0](/php/docs/reference/cloud-ai-platform/0.29.0/V1.Annotation)\n- [0.28.0](/php/docs/reference/cloud-ai-platform/0.28.0/V1.Annotation)\n- [0.27.0](/php/docs/reference/cloud-ai-platform/0.27.0/V1.Annotation)\n- [0.26.2](/php/docs/reference/cloud-ai-platform/0.26.2/V1.Annotation)\n- [0.25.0](/php/docs/reference/cloud-ai-platform/0.25.0/V1.Annotation)\n- [0.24.0](/php/docs/reference/cloud-ai-platform/0.24.0/V1.Annotation)\n- [0.23.0](/php/docs/reference/cloud-ai-platform/0.23.0/V1.Annotation)\n- [0.22.0](/php/docs/reference/cloud-ai-platform/0.22.0/V1.Annotation)\n- [0.21.0](/php/docs/reference/cloud-ai-platform/0.21.0/V1.Annotation)\n- [0.20.0](/php/docs/reference/cloud-ai-platform/0.20.0/V1.Annotation)\n- [0.19.0](/php/docs/reference/cloud-ai-platform/0.19.0/V1.Annotation)\n- [0.18.0](/php/docs/reference/cloud-ai-platform/0.18.0/V1.Annotation)\n- [0.17.0](/php/docs/reference/cloud-ai-platform/0.17.0/V1.Annotation)\n- [0.16.0](/php/docs/reference/cloud-ai-platform/0.16.0/V1.Annotation)\n- [0.15.0](/php/docs/reference/cloud-ai-platform/0.15.0/V1.Annotation)\n- [0.13.0](/php/docs/reference/cloud-ai-platform/0.13.0/V1.Annotation)\n- [0.12.0](/php/docs/reference/cloud-ai-platform/0.12.0/V1.Annotation)\n- [0.11.1](/php/docs/reference/cloud-ai-platform/0.11.1/V1.Annotation)\n- [0.10.0](/php/docs/reference/cloud-ai-platform/0.10.0/V1.Annotation) \nReference documentation and code samples for the Google Cloud Ai Platform V1 Client class Annotation.\n\nUsed to assign specific AnnotationSpec to a particular area of a DataItem or\nthe whole part of the DataItem.\n\nGenerated from protobuf message `google.cloud.aiplatform.v1.Annotation`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ AIPlatform \\\\ V1\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getName\n\nOutput only. Resource name of the Annotation.\n\n### setName\n\nOutput only. Resource name of the Annotation.\n\n### getPayloadSchemaUri\n\nRequired. Google Cloud Storage URI points to a YAML file describing\n[payload](/php/docs/reference/cloud-ai-platform/latest/V1.Annotation#_Google_Cloud_AIPlatform_V1_Annotation__getPayload__). The schema is\ndefined as an [OpenAPI 3.0.2 Schema\nObject](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject).\n\nThe schema files that can be used here are found in\ngs://google-cloud-aiplatform/schema/dataset/annotation/, note that the\nchosen schema must be consistent with the parent Dataset's\n[metadata](/php/docs/reference/cloud-ai-platform/latest/V1.Dataset#_Google_Cloud_AIPlatform_V1_Dataset__getMetadataSchemaUri__).\n\n### setPayloadSchemaUri\n\nRequired. Google Cloud Storage URI points to a YAML file describing\n[payload](/php/docs/reference/cloud-ai-platform/latest/V1.Annotation#_Google_Cloud_AIPlatform_V1_Annotation__getPayload__). The schema is\ndefined as an [OpenAPI 3.0.2 Schema\nObject](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md#schemaObject).\n\nThe schema files that can be used here are found in\ngs://google-cloud-aiplatform/schema/dataset/annotation/, note that the\nchosen schema must be consistent with the parent Dataset's\n[metadata](/php/docs/reference/cloud-ai-platform/latest/V1.Dataset#_Google_Cloud_AIPlatform_V1_Dataset__getMetadataSchemaUri__).\n\n### getPayload\n\nRequired. The schema of the payload can be found in\n[payload_schema](/php/docs/reference/cloud-ai-platform/latest/V1.Annotation#_Google_Cloud_AIPlatform_V1_Annotation__getPayloadSchemaUri__).\n\n### hasPayload\n\n### clearPayload\n\n### setPayload\n\nRequired. The schema of the payload can be found in\n[payload_schema](/php/docs/reference/cloud-ai-platform/latest/V1.Annotation#_Google_Cloud_AIPlatform_V1_Annotation__getPayloadSchemaUri__).\n\n### getCreateTime\n\nOutput only. Timestamp when this Annotation was created.\n\n### hasCreateTime\n\n### clearCreateTime\n\n### setCreateTime\n\nOutput only. Timestamp when this Annotation was created.\n\n### getUpdateTime\n\nOutput only. Timestamp when this Annotation was last updated.\n\n### hasUpdateTime\n\n### clearUpdateTime\n\n### setUpdateTime\n\nOutput only. Timestamp when this Annotation was last updated.\n\n### getEtag\n\nOptional. Used to perform consistent read-modify-write updates. If not set,\na blind \"overwrite\" update happens.\n\n### setEtag\n\nOptional. Used to perform consistent read-modify-write updates. If not set,\na blind \"overwrite\" update happens.\n\n### getAnnotationSource\n\nOutput only. The source of the Annotation.\n\n### hasAnnotationSource\n\n### clearAnnotationSource\n\n### setAnnotationSource\n\nOutput only. The source of the Annotation.\n\n### getLabels\n\nOptional. The labels with user-defined metadata to organize your\nAnnotations.\n\nLabel keys and values can be no longer than 64 characters\n(Unicode codepoints), can only contain lowercase letters, numeric\ncharacters, underscores and dashes. International characters are allowed.\nNo more than 64 user labels can be associated with one Annotation(System\nlabels are excluded).\nSee \u003chttps://goo.gl/xmQnxf\u003e for more information and examples of labels.\nSystem reserved label keys are prefixed with \"aiplatform.googleapis.com/\"\nand are immutable. Following system labels exist for each Annotation:\n\n- \"aiplatform.googleapis.com/annotation_set_name\": optional, name of the UI's annotation set this Annotation belongs to. If not set, the Annotation is not visible in the UI.\n- \"aiplatform.googleapis.com/payload_schema\": output only, its value is the [payload_schema's](/php/docs/reference/cloud-ai-platform/latest/V1.Annotation#_Google_Cloud_AIPlatform_V1_Annotation__getPayloadSchemaUri__) title.\n\n### setLabels\n\nOptional. The labels with user-defined metadata to organize your\nAnnotations.\n\nLabel keys and values can be no longer than 64 characters\n(Unicode codepoints), can only contain lowercase letters, numeric\ncharacters, underscores and dashes. International characters are allowed.\nNo more than 64 user labels can be associated with one Annotation(System\nlabels are excluded).\nSee \u003chttps://goo.gl/xmQnxf\u003e for more information and examples of labels.\nSystem reserved label keys are prefixed with \"aiplatform.googleapis.com/\"\nand are immutable. Following system labels exist for each Annotation:\n\n- \"aiplatform.googleapis.com/annotation_set_name\": optional, name of the UI's annotation set this Annotation belongs to. If not set, the Annotation is not visible in the UI.\n- \"aiplatform.googleapis.com/payload_schema\": output only, its value is the [payload_schema's](/php/docs/reference/cloud-ai-platform/latest/V1.Annotation#_Google_Cloud_AIPlatform_V1_Annotation__getPayloadSchemaUri__) title."]]