Wir aktualisieren die Data API, damit sie der Zählweise von YouTube-Aufrufen für Kurzvideos entspricht.
Weitere Informationen
Watermarks: set
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Hiermit wird ein Wasserzeichenbild auf YouTube hochgeladen und für einen Kanal festgelegt.
Diese Methode unterstützt den Medienupload. Hochgeladene Dateien müssen den folgenden Einschränkungen entsprechen:
- Maximale Dateigröße:10 MB
- Zulässige MIME-Typen für Medien:
image/jpeg, image/png, application/octet-stream
Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode hat Kontingentkosten in Höhe von 50 Einheiten.
Anfrage
HTTP-Anfrage
POST https://www.googleapis.com/upload/youtube/v3/watermarks/set
Autorisierung
Für diese Anfrage ist eine Autorisierung mit mindestens einem der folgenden Bereiche erforderlich. Weitere Informationen zu Authentifizierung und Autorisierung finden Sie unter OAuth 2.0-Autorisierung implementieren.
| Umfang |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parameter
In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.
| Parameter |
| Erforderliche Parameter |
channelId |
string
Der Parameter channelId gibt die YouTube-Kanal-ID an, für die das Wasserzeichen bereitgestellt wird. |
| Optionale Parameter |
onBehalfOfContentOwner |
string
Hinweis:Dieser Parameter ist ausschließlich für YouTube-Contentpartner gedacht.
Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube CMS-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Dieser Parameter richtet sich an YouTube-Contentpartner, die viele verschiedene YouTube-Kanäle haben und verwalten. So können Rechteinhaber sich einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten angeben zu müssen. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein. |
Anfragetext
Geben Sie im Anfragetext eine watermark-Ressource an.
Antwort
Bei Erfolg gibt diese Methode den HTTP-Statuscode 204 No Content zurück.
Fehler
In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. Weitere Informationen findest du unter YouTube Data API – Fehler.
| Fehlertyp |
Fehlerdetails |
Beschreibung |
badRequest (400) |
imageFormatUnsupported |
Das von Ihnen bereitgestellte Bild hat ein nicht unterstütztes Format. |
badRequest (400) |
imageTooTall |
Das von Ihnen bereitgestellte Bild ist zu hoch. |
badRequest (400) |
imageTooWide |
Das von Ihnen bereitgestellte Bild ist zu breit. |
badRequest (400) |
mediaBodyRequired |
Die Anfrage enthält keine Bildinhalte. |
forbidden (403) |
forbidden |
Das Wasserzeichen kann für den angegebenen Kanal nicht festgelegt werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert oder der Parameter channelId ist auf einen ungültigen Wert festgelegt. |
Testen!
Verwenden Sie die APIs Explorer, um diese API aufzurufen und die API-Anfrage und ‑Antwort zu sehen.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-11-23 (UTC).
[null,null,["Zuletzt aktualisiert: 2024-11-23 (UTC)."],[[["\u003cp\u003eThis method enables uploading a watermark image to YouTube and applying it to a specific channel, supporting file sizes up to 10MB.\u003c/p\u003e\n"],["\u003cp\u003eAccepted image formats for the watermark include JPEG and PNG, and the method uses \u003ccode\u003eapplication/octet-stream\u003c/code\u003e as an accepted MIME type.\u003c/p\u003e\n"],["\u003cp\u003eSetting a watermark using this method consumes 50 quota units, and requires proper authorization using at least one of the specified scopes.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003echannelId\u003c/code\u003e is a required parameter, while \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e is an optional parameter meant only for YouTube content partners.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns a \u003ccode\u003e204 No Content\u003c/code\u003e status, and common errors include unsupported image format, incorrect image dimensions, and missing image content.\u003c/p\u003e\n"]]],["The content describes uploading a watermark image to a YouTube channel using the `watermarks/set` method. This process involves a POST request to the API endpoint, requiring a `channelId` parameter and authorization with specific scopes. The image file must be under 10MB and of `image/jpeg`, `image/png`, or `application/octet-stream` MIME type. This operation costs 50 quota units. A successful request returns a `204` status; errors can include invalid format, size issues, or authorization problems.\n"],null,["# Watermarks: set\n\nUploads a watermark image to YouTube and sets it for a channel.\n\nThis method supports media upload. Uploaded files must conform to these constraints:\n\n- **Maximum file size:** 10MB\n- **Accepted Media MIME types:** `image/jpeg`, `image/png`, `application/octet-stream`\n\n**Quota impact:** A call to this method has a [quota cost](/youtube/v3/getting-started#quota) of 50 units.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/upload/youtube/v3/watermarks/set\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes. To read more about authentication and authorization, see [Implementing OAuth 2.0 authorization](/youtube/v3/guides/authentication).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtubepartner` |\n| `https://www.googleapis.com/auth/youtube.upload` |\n| `https://www.googleapis.com/auth/youtube` |\n| `https://www.googleapis.com/auth/youtube.force-ssl` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `channelId` | `string` The **channelId** parameter specifies the YouTube channel ID for which the watermark is being provided. |\n| **Optional parameters** |||\n| `onBehalfOfContentOwner` | `string` **Note:** This parameter is intended exclusively for YouTube content partners. The **onBehalfOfContentOwner** parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner. |\n\n### Request body\n\nProvide a [watermark](/youtube/v3/docs/watermarks#resource) resource in the request body.\n\nResponse\n--------\n\nIf successful, this method returns an HTTP `204 No Content` status code.\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. For more details, see [YouTube Data API - Errors](/youtube/v3/docs/errors).\n\n| Error type | Error detail | Description |\n|--------------------|--------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `badRequest (400)` | `imageFormatUnsupported` | The image you provided is in an unsupported format. |\n| `badRequest (400)` | `imageTooTall` | The image you provided is too tall. |\n| `badRequest (400)` | `imageTooWide` | The image you provided is too wide. |\n| `badRequest (400)` | `mediaBodyRequired` | The request does not include the image content. |\n| `forbidden (403)` | `forbidden` | The watermark can't be set for the specified channel. The request may not be properly authorized, or the `channelId` parameter is set to an invalid value. |\n\nTry it!\n-------\n\nUse the APIs Explorer to call this API and see the API request and response."]]
