{"openapi":"3.0.0","info":{"description":"YouTube Reporting API enables developers to schedule reporting jobs and download bulk reports containing YouTube Analytics data","version":[{"name":"v1","value":"v1"}]},"servers":[{"description":"YouTube Reporting API enables developers to schedule reporting jobs and download bulk reports containing YouTube Analytics data","url":"https://api.apirails.com/youtubereporting"}],"paths":{"/reportTypes":{"get":{"tags":["Report Types"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"The content owner's external ID","schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Requested page size","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"A token identifying a page of results","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/reporting/v1/reference/rest/v1/reportTypes/list","api_endpoint":"https://youtubereporting.googleapis.com/v1/reportTypes"},"summary":"List report types","description":"Returns a list of report types that the channel or content owner can retrieve","security":[{"bearerAuth":[]}]}},"/jobs":{"get":{"tags":["Jobs"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"The content owner's external ID","schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Requested page size","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"A token identifying a page of results","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs/list","api_endpoint":"https://youtubereporting.googleapis.com/v1/jobs"},"summary":"List jobs","description":"Lists reporting jobs that have been scheduled for a channel or content owner","security":[{"bearerAuth":[]}]},"post":{"tags":["Jobs"],"parameters":[{"name":"onBehalfOfContentOwner","in":"query","description":"The content owner's external ID","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs/create","api_endpoint":"https://youtubereporting.googleapis.com/v1/jobs"},"summary":"Create job","description":"Creates a reporting job. By creating a job, you are instructing YouTube to generate that report on a daily basis","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"The server-generated ID of the job"},"name":{"type":"string","description":"The name of the job"},"reportTypeId":{"type":"string","description":"The type of the report this job creates","required":true}}},"example":{"id":"","name":"","reportTypeId":""}}}}}},"/jobs/{jobId}":{"get":{"tags":["Jobs"],"parameters":[{"name":"jobId","in":"path","description":"The ID of the job to retrieve","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"The content owner's external ID","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs/get","api_endpoint":"https://youtubereporting.googleapis.com/v1/jobs/{jobId}"},"summary":"Get job","description":"Retrieves information about a specific reporting job","security":[{"bearerAuth":[]}]},"delete":{"tags":["Jobs"],"parameters":[{"name":"jobId","in":"path","description":"The ID of the job to delete","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"The content owner's external ID","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs/delete","api_endpoint":"https://youtubereporting.googleapis.com/v1/jobs/{jobId}"},"summary":"Delete job","description":"Deletes a reporting job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/jobs/{jobId}/reports":{"get":{"tags":["Reports"],"parameters":[{"name":"jobId","in":"path","description":"The ID of the job","required":true,"schema":{"type":"string","example":""}},{"name":"createdAfter","in":"query","description":"If set, only reports created after the specified date/time are returned","schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"The content owner's external ID","schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Requested page size","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"A token identifying a page of results","schema":{"type":"string","example":""}},{"name":"startTimeAtOrAfter","in":"query","description":"If set, only reports whose start time is greater than or equal to the specified date/time are returned","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs.reports/list","api_endpoint":"https://youtubereporting.googleapis.com/v1/jobs/{jobId}/reports"},"summary":"List job reports","description":"Lists reports that have been generated for the specified reporting job","security":[{"bearerAuth":[]}]}},"/jobs/{jobId}/reports/{reportId}":{"get":{"tags":["Reports"],"parameters":[{"name":"jobId","in":"path","description":"The ID of the job","required":true,"schema":{"type":"string","example":""}},{"name":"reportId","in":"path","description":"The ID of the report to retrieve","required":true,"schema":{"type":"string","example":""}},{"name":"onBehalfOfContentOwner","in":"query","description":"The content owner's external ID","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs.reports/get","api_endpoint":"https://youtubereporting.googleapis.com/v1/jobs/{jobId}/reports/{reportId}"},"summary":"Get report","description":"Retrieves the metadata for a specific report","security":[{"bearerAuth":[]}]}},"/media/{resourceName}":{"get":{"tags":["Media"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/youtube/reporting/v1/reference/rest/v1/media/download","api_endpoint":"https://youtubereporting.googleapis.com/v1/media/{resourceName}"},"summary":"Download media","description":"Method for media download","security":[{"bearerAuth":[]}]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}