/v1/jobs/{jobId}

GET

/v1/jobs/{jobId}

jobs

Gets a job.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://youtubereporting.googleapis.com//v1/jobs/'

Response Example

{
  "createTime": "string",
  "expireTime": "string",
  "id": "string",
  "name": "string",
  "reportTypeId": "string",
  "systemManaged": true
}

Request

Path Params

jobId

string

required

The ID of the job to retrieve.

Query Params

onBehalfOfContentOwner

string

optional

The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).

Responses

🟢200Successful response

application/json

Body

A job creating reports of a specific type.

createTime

string <google-datetime>

optional

The creation date/time of the job.

expireTime

string <google-datetime>

optional

The date/time when this job will expire/expired. After a job expired, no new reports are generated.

string

optional

The server-generated ID of the job (max. 40 characters).

name

string

optional

The name of the job (max. 100 characters).

reportTypeId

string

optional

The type of reports this job creates. Corresponds to the ID of a ReportType.

systemManaged

boolean

optional

True if this a system-managed job that cannot be modified by the user; otherwise false.

/v1/jobs/{jobId}

/v1/jobs/{jobId}/reports