REST Resource: package
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Package
A package
resource represents a group of files that is delivered via the web, SFTP, or another delivery mechanism. The API currently supports the ability to upload a package containing exactly one metadata file or to retrieve information about a previously uploaded package.
StatusReport
This object contains information that describes the source of the package status report.
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eA \u003ccode\u003epackage\u003c/code\u003e resource represents a group of files delivered via web, SFTP, or other mechanisms, currently supporting the upload of a package with one metadata file or retrieving data about a previously uploaded package.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epackage\u003c/code\u003e resource's JSON representation includes details like \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003euploaderName\u003c/code\u003e, \u003ccode\u003econtent\u003c/code\u003e, \u003ccode\u003elocale\u003c/code\u003e, \u003ccode\u003ecustomIds\u003c/code\u003e, \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003etype\u003c/code\u003e, \u003ccode\u003etimeCreated\u003c/code\u003e, \u003ccode\u003estatus\u003c/code\u003e, \u003ccode\u003estatusReports\u003c/code\u003e, and \u003ccode\u003eid\u003c/code\u003e, all providing comprehensive information about the package.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eStatusReport\u003c/code\u003e objects contain information describing the source of a package status report, including \u003ccode\u003estatusContent\u003c/code\u003e and \u003ccode\u003estatusFileName\u003c/code\u003e, which are specifically used in Hybrid implementations.\u003c/p\u003e\n"],["\u003cp\u003eAvailable methods for managing \u003ccode\u003epackage\u003c/code\u003e resources are \u003ccode\u003eget\u003c/code\u003e, which retrieves information for a specific package, and \u003ccode\u003einsert\u003c/code\u003e, used to insert a metadata-only package.\u003c/p\u003e\n"]]],["A `package` resource represents a group of files delivered via various mechanisms. Users can upload a package containing one metadata file or retrieve information about an existing package. Key attributes include `kind`, `uploaderName`, `content`, `locale`, `customIds`, `name`, `type`, `timeCreated`, `status`, `statusReports`, and `id`. The `StatusReport` details the package status source, including `statusContent` and `statusFileName`. Supported methods are `get` to retrieve package information and `insert` to upload a metadata-only package.\n"],null,["# REST Resource: package\n\n- [Resource: Package](#Package)\n - [JSON representation](#Package.SCHEMA_REPRESENTATION)\n- [StatusReport](#StatusReport)\n - [JSON representation](#StatusReport.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Package\n-----------------\n\nA `package` resource represents a group of files that is delivered via the web, SFTP, or another delivery mechanism. The API currently supports the ability to upload a package containing exactly one metadata file or to retrieve information about a previously uploaded package.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"uploaderName\": string, \"content\": string, \"locale\": string, \"customIds\": [ string ], \"name\": string, \"type\": string, \"timeCreated\": string, \"status\": string, \"statusReports\": [ { object (/youtube/partner/reference/rest/v1/package#StatusReport) } ], \"id\": string } ``` |\n\n| Fields ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` The type of the API resource. For `package` resources, this value is `youtubePartner#package`. |\n| `uploaderName` | `string` The uploader name. |\n| `content` | `string` The package's metadata file contents. |\n| `locale` | `string` The desired locale of the error messages as defined in BCP 47 (http: //tools.ietf.org/html/bcp47). For example, \"en-US\" or \"de\". If not // specified we will return the error messages in English (\"en\"). |\n| `customIds[]` | `string` The list of customer IDs. |\n| `name` | `string` The package name. |\n| `type` | `string` The package type. |\n| `timeCreated` | `string` The package creation time. The value is specified in [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) (`YYYY-MM-DDThh:mm:ss.000Z`) format. |\n| `status` | `string` The package status. |\n| `statusReports[]` | `object (`[StatusReport](/youtube/partner/reference/rest/v1/package#StatusReport)`)` The package status reports. |\n| `id` | `string` An ID that YouTube assigns and uses to uniquely identify the package. |\n\nStatusReport\n------------\n\nThis object contains information that describes the source of the package status report.\n\n| JSON representation |\n|---------------------------------------------------------------|\n| ``` { \"statusContent\": string, \"statusFileName\": string } ``` |\n\n| Fields ||\n|------------------|------------------------------------------------------------------|\n| `statusContent` | `string` The content of the report message. Used only in Hybrid. |\n| `statusFileName` | `string` Status file name. Used only in Hybrid. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------|--------------------------------------------------|\n| ### [get](/youtube/partner/reference/rest/v1/package/get) | Retrieves information for the specified package. |\n| ### [insert](/youtube/partner/reference/rest/v1/package/insert) | Inserts a metadata-only package. |"]]
