{"id":548,"date":"2025-10-26T22:53:23","date_gmt":"2025-10-26T22:53:23","guid":{"rendered":"https:\/\/ykim.synology.me\/wordpress\/?p=548"},"modified":"2025-10-26T22:53:28","modified_gmt":"2025-10-26T22:53:28","slug":"how-to-create-a-job-in-the-youtube-studio-reports-section-or-via-the-api","status":"publish","type":"post","link":"https:\/\/ykim.synology.me\/wordpress\/how-to-create-a-job-in-the-youtube-studio-reports-section-or-via-the-api-548\/","title":{"rendered":"How to create a job in the YouTube Studio ‘Reports’ section or via the API"},"content":{"rendered":"\n

You can create a YouTube Reporting job (which tells YouTube to generate daily bulk data reports for you) either through the API or, for certain system-managed reports, they might be automatically available via the Studio interface.1<\/sup><\/p>\n\n\n\n

\n\n\n\n

Method 1: Via the YouTube Studio ‘Reports’ Section<\/h2>\n\n\n\n

Currently, you cannot manually create new<\/em> custom Reporting API jobs directly within the standard YouTube Studio interface.<\/strong> The Studio interface focuses on the Analytics<\/em> API (visual dashboards, customizable charts, exporting the current view) rather than scheduling bulk CSV downloads via the Reporting<\/em> API.<\/p>\n\n\n\n

However, if you are a Content Owner<\/strong> (usually managing multiple channels or dealing with Content ID), YouTube automatically generates certain “System-Managed Reports” for you.2<\/sup> These cover things like ad revenue and asset performance.3<\/sup><\/p>\n\n\n\n

To access and download these pre-generated System-Managed Reports:<\/strong><\/p>\n\n\n\n

    \n
  1. Sign in to YouTube Studio<\/strong>.<\/li>\n\n\n\n
  2. Make sure you are viewing as the Content Owner<\/strong> (you might need to switch accounts using your profile picture in the top right).<\/li>\n\n\n\n
  3. From the left menu, select Reports<\/strong>. \ud83d\udcc4<\/li>\n\n\n\n
  4. At the top of the page, select the type<\/strong> of report you want (e.g., Financial Summary, Asset Performance).<\/li>\n\n\n\n
  5. Choose the frequency<\/strong> (Weekly or Monthly) and the version<\/strong> of the report.<\/li>\n\n\n\n
  6. Click the report name for the desired date range to download the CSV file.<\/li>\n<\/ol>\n\n\n\n
    \n\n\n\n

    Method 2: Via the YouTube Reporting API (Using Python)<\/h2>\n\n\n\n

    This is the standard way to create custom<\/em> reporting jobs for various data types (like daily video views, demographics, traffic sources, etc.).<\/p>\n\n\n\n

    Prerequisites:<\/strong><\/p>\n\n\n\n

      \n
    • Python installed.4<\/sup><\/li>\n\n\n\n
    • Google API Client Library for Python installed:Bashpip install google-api-python-client google-auth-oauthlib google-auth<\/code><\/li>\n\n\n\n
    • client_secrets.json<\/code> file downloaded from your Google Cloud project (with YouTube Reporting API enabled).<\/li>\n\n\n\n
    • OAuth 2.0 authentication handled (the script below includes this).<\/li>\n<\/ul>\n\n\n\n

      Python Code (create_job.py<\/code>):<\/strong><\/p>\n\n\n\n

      Python<\/p>\n\n\n

      \nimport os\nimport pickle\nimport google_auth_oauthlib.flow\nimport googleapiclient.discovery\nimport googleapiclient.errors\nfrom google.auth.transport.requests import Request\n\n# --- CONFIGURATION ---\n# Need read\/write scope to create jobs\nSCOPES = ['https:\/\/www.googleapis.com\/auth\/yt-analytics.readonly']\nAPI_SERVICE_NAME = 'youtubereporting'\nAPI_VERSION = 'v1'\nCLIENT_SECRETS_FILE = 'client_secrets.json'\nTOKEN_PICKLE_FILE = 'token.pickle' # Same file as the download script\n\n# --- AUTHENTICATION ---\ndef get_authenticated_service():\n    """Handles OAuth 2.0 flow and returns an authenticated API service."""\n    creds = None\n    if os.path.exists(TOKEN_PICKLE_FILE):\n        with open(TOKEN_PICKLE_FILE, 'rb') as token:\n            creds = pickle.load(token)\n\n    if not creds or not creds.valid:\n        if creds and creds.expired and creds.refresh_token:\n            try:\n                creds.refresh(Request())\n            except Exception as e:\n                 print(f"Error refreshing token: {e}. Re-authenticating.")\n                 creds = None # Force re-authentication if refresh fails\n\n        if not creds: # Need to authenticate\n            if not os.path.exists(CLIENT_SECRETS_FILE):\n                print(f"Error: {CLIENT_SECRETS_FILE} not found.")\n                exit()\n            flow = google_auth_oauthlib.flow.InstalledAppFlow.from_client_secrets_file(\n                CLIENT_SECRETS_FILE, SCOPES)\n            creds = flow.run_local_server(port=0)\n\n        with open(TOKEN_PICKLE_FILE, 'wb') as token:\n            pickle.dump(creds, token)\n\n    return googleapiclient.discovery.build(\n        API_SERVICE_NAME, API_VERSION, credentials=creds)\n\n# --- List Available Report Types ---\ndef list_report_types(service):\n    """Lists available report types."""\n    print("Fetching available report types...")\n    try:\n        results = service.reportTypes().list().execute()\n        report_types = results.get('reportTypes', [])\n\n        if not report_types:\n            print("No report types found.")\n            return None\n        else:\n            print("Available Report Types:")\n            for i, r_type in enumerate(report_types):\n                print(f"  [{i+1}] ID: {r_type['id']}")\n                print(f"      Name: {r_type['name']}")\n            return report_types\n    except googleapiclient.errors.HttpError as e:\n        print(f"An API error occurred: {e}")\n        return None\n\n\n# --- Create Job Function ---\ndef create_reporting_job(service, report_type_id, job_name):\n    """Creates a new reporting job."""\n    print(f"\\nCreating job '{job_name}' for report type '{report_type_id}'...")\n    job_body = {\n        'reportTypeId': report_type_id,\n        'name': job_name\n    }\n    try:\n        response = service.jobs().create(body=job_body).execute()\n        print("\\n--- Job Created Successfully ---")\n        print(f"Job ID: {response['id']}")\n        print(f"Job Name: {response['name']}")\n        print(f"Report Type ID: {response['reportTypeId']}")\n        print(f"Create Time: {response['createTime']}")\n        print("--------------------------------")\n        print("Reports will start generating within 48 hours.")\n        return response\n    except googleapiclient.errors.HttpError as e:\n        print(f"An API error occurred: {e}")\n        error_details = e.resp.get('content', b'').decode('utf-8')\n        if "jobs.create" in str(e) and "409" in str(e): # 409 Conflict means it likely already exists\n             print("Error: A job with this reportTypeId might already exist for your channel.")\n        elif "403" in str(e) and "system-managed" in error_details.lower():\n             print("Error: Cannot create jobs for system-managed report types.")\n        else:\n             print(f"Details: {error_details}")\n        return None\n\n# --- MAIN EXECUTION ---\ndef main():\n    service = get_authenticated_service()\n\n    available_types = list_report_types(service)\n    if not available_types:\n        return\n\n    # --- User Input ---\n    while True:\n        try:\n            choice = int(input(f"Enter the number of the report type you want to create a job for (1-{len(available_types)}): "))\n            if 1 <= choice <= len(available_types):\n                selected_report_type = available_types[choice-1]\n                break\n            else:\n                print("Invalid choice.")\n        except ValueError:\n            print("Please enter a number.")\n\n    job_name_input = input(f"Enter a name for this job (e.g., 'Daily {selected_report_type['name']}'): ")\n    if not job_name_input:\n         job_name_input = f"My {selected_report_type['name']} Job" # Default name\n\n    # --- Create the Job ---\n    create_reporting_job(service, selected_report_type['id'], job_name_input)\n\nif __name__ == '__main__':\n    main()\n\n<\/pre><\/div>\n\n\n
      How to Use the API Script:<\/strong><\/p>\n\n\n\n
        \n
      1. Save the code as create_job.py<\/code>.5<\/sup><\/li>\n\n\n\n
      2. Make sure client_secrets.json<\/code> is in the same folder.<\/li>\n\n\n\n
      3. Run it: python create_job.py<\/code><\/li>\n\n\n\n
      4. It will first authenticate (if needed).<\/li>\n\n\n\n
      5. Then, it lists the available report types you can create jobs for (e.g., channel_basic_a2<\/code>, channel_traffic_source_a2<\/code>, etc.).<\/li>\n\n\n\n
      6. It prompts you to enter the number corresponding to the report type you want.<\/li>\n\n\n\n
      7. It prompts you to enter a name for the job.<\/li>\n\n\n\n
      8. It calls the jobs.create<\/code> method and confirms if the job was created successfully.6<\/sup><\/li>\n<\/ol>\n\n\n\n
        Once created, YouTube will start generating daily CSV reports for that job, which you can then download using the other<\/em> script (from the previous answer). Remember, it takes up to 48 hours for the first report to appear.7<\/sup><\/p>\n\n\n\n
        <\/p>\n
        <\/div>
        <\/div>","protected":false},"excerpt":{"rendered":"
        You can create a YouTube Reporting job (which tells YouTube to generate daily bulk data reports for you) either through the API or, for certain system-managed reports, they might be automatically available via the Studio interface.1 Method 1: Via the YouTube Studio ‘Reports’ Section Currently, you cannot manually create new custom Reporting API jobs directly…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"_kadence_starter_templates_imported_post":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","yasr_overall_rating":0,"yasr_post_is_review":"","yasr_auto_insert_disabled":"","yasr_review_type":"","fifu_image_url":"","fifu_image_alt":"","iawp_total_views":0,"footnotes":""},"categories":[55,10],"tags":[],"class_list":["post-548","post","type-post","status-publish","format-standard","hentry","category-application-slug","category-software-slug"],"yasr_visitor_votes":{"stars_attributes":{"read_only":false,"span_bottom":false},"number_of_votes":0,"sum_votes":0},"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/posts\/548","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/comments?post=548"}],"version-history":[{"count":1,"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/posts\/548\/revisions"}],"predecessor-version":[{"id":549,"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/posts\/548\/revisions\/549"}],"wp:attachment":[{"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/media?parent=548"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/categories?post=548"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/tags?post=548"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}