Required. The parent, which owns this collection of ObservationJobs. Format: projects/{project}/locations/{location}
Query parameters
Parameters
pageSize
integer
Optional. The maximum number of ObservationJobs to return. The service may return fewer than this value. If unspecified, at most 10 ObservationJobs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
pageToken
string
Optional. A page token, received from a previous observationJobs.list call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to observationJobs.list must match the call that provided the page token.
Request body
The request body must be empty.
Response body
Message for response to listing ObservationJobs
If successful, the response body contains data with the following structure:
[[["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-07-28 UTC."],[[["\u003cp\u003eThis API endpoint \u003ccode\u003eobservationJobs.list\u003c/code\u003e retrieves all ObservationJobs for a specified project and location using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL follows gRPC Transcoding syntax and requires a \u003ccode\u003eparent\u003c/code\u003e path parameter specifying the project and location.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e allow for pagination, controlling the number of results and retrieving subsequent pages respectively.\u003c/p\u003e\n"],["\u003cp\u003eThe response body will contain a list of \u003ccode\u003eobservationJobs\u003c/code\u003e, a \u003ccode\u003enextPageToken\u003c/code\u003e for continued pagination, and a list of \u003ccode\u003eunreachable\u003c/code\u003e locations.\u003c/p\u003e\n"],["\u003cp\u003eTo use this API, an OAuth scope of \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the IAM permission \u003ccode\u003eapim.observationJobs.list\u003c/code\u003e on the parent resource are required.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.observationJobs.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListObservationJobsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n\nobservationJobs.list gets all ObservationJobs for a given project and location.\n\n### HTTP request\n\n`GET https://apim.googleapis.com/v1alpha/{parent=projects/*/locations/*}/observationJobs`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nMessage for response to listing ObservationJobs\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `apim.observationJobs.list`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]