Dla YouTube Content ID API dostępne są te przykłady kodu, które korzystają z biblioteki klienta interfejsów API Google dla Java.
Uwaga: te przykłady importują usługę YouTubePartner z com.google.apis:google-api-services-youtubePartner. Aby pobrać wygenerowane powiązania interfejsu YouTube Content ID API niezbędne do uruchomienia tych przykładów, zapoznaj się z dokumentacją bibliotek klienta.
Pobieranie zarządzanych kanałów właściciela treści
Ten przykładowy kod wywołuje metodę channels.list interfejsu YouTube Data API, aby pobrać listę kanałów zarządzanych przez właściciela treści, który wysyła żądanie do interfejsu API.
/* * Copyright (c) 2026 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except * in compliance with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package com.google.api.services.samples.youtube.cmdline.partner; import com.google.api.client.auth.oauth2.Credential; import com.google.api.client.googleapis.json.GoogleJsonResponseException; import com.google.api.services.samples.youtube.cmdline.Auth; import com.google.api.services.youtube.YouTube; import com.google.api.services.youtube.model.Channel; import com.google.api.services.youtube.model.ChannelListResponse; import com.google.api.services.youtubePartner.YouTubePartner; import com.google.api.services.youtubePartner.model.ContentOwnerListResponse; import java.io.IOException; import java.util.Arrays; import java.util.List; /** * This sample retrieves a list of channels managed by the content owner * associated with the currently authenticated user's account. */ public class MyManagedChannels { private static YouTube youtube; private static YouTubePartner youtubePartner; public static void main(String[] args) { List<String> scopes = Arrays.asList( "https://www.googleapis.com/auth/youtube.readonly", "https://www.googleapis.com/auth/youtubepartner"); try { Credential credential = Auth.authorize(scopes, "mymanagedchannels"); youtube = new YouTube.Builder(Auth.HTTP_TRANSPORT, Auth.JSON_FACTORY, credential) .setApplicationName("youtube-cmdline-mymanagedchannels-sample") .build(); youtubePartner = new YouTubePartner.Builder(Auth.HTTP_TRANSPORT, Auth.JSON_FACTORY, credential) .setApplicationName("youtube-cmdline-mymanagedchannels-sample") .build(); String contentOwnerId = getContentOwnerId(youtubePartner); listManagedChannels(youtube, contentOwnerId); } catch (GoogleJsonResponseException e) { System.err.println("GoogleJsonResponseException code: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); e.printStackTrace(); } catch (IOException e) { System.err.println("IOException: " + e.getMessage()); e.printStackTrace(); } catch (Throwable t) { System.err.println("Throwable: " + t.getMessage()); t.printStackTrace(); } } /** * Calls the contentOwners.list method to retrieve the ID of the content * owner associated with the currently authenticated user's account. */ private static String getContentOwnerId(YouTubePartner youtubePartner) throws IOException { ContentOwnerListResponse response = youtubePartner.contentOwners() .list() .setFetchMine(true) .execute(); return response.getItems().get(0).getId(); } /** * Retrieves and prints a list of channels that the content owner manages. */ private static void listManagedChannels(YouTube youtube, String contentOwnerId) throws IOException { System.out.println("Channels managed by content owner '" + contentOwnerId + "':"); YouTube.Channels.List request = youtube.channels() .list("snippet") .setOnBehalfOfContentOwner(contentOwnerId) .setManagedByMe(true) .setMaxResults(50L); String nextPageToken = ""; do { request.setPageToken(nextPageToken); ChannelListResponse response = request.execute(); List<Channel> channels = response.getItems(); if (channels != null) { for (Channel channel : channels) { String title = channel.getSnippet().getTitle(); String id = channel.getId(); System.out.println(" " + title + " (" + id + ")"); } } nextPageToken = response.getNextPageToken(); } while (nextPageToken != null); } }
Tworzenie etykiet zasobów i zarządzanie nimi
Poniższy przykładowy kod wykonuje serię wywołań interfejsu API, które pokazują, jak tworzyć i używać etykiet komponentów do kategoryzowania i wyszukiwania elementów w bibliotece komponentów.
/* * Copyright (c) 2026 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except * in compliance with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package com.google.api.services.samples.youtube.cmdline.partner; import com.google.api.client.auth.oauth2.Credential; import com.google.api.client.googleapis.json.GoogleJsonResponseException; import com.google.api.services.samples.youtube.cmdline.Auth; import com.google.api.services.youtubePartner.YouTubePartner; import com.google.api.services.youtubePartner.model.Asset; import com.google.api.services.youtubePartner.model.AssetLabel; import com.google.api.services.youtubePartner.model.AssetLabelListResponse; import com.google.api.services.youtubePartner.model.AssetSearchResponse; import com.google.api.services.youtubePartner.model.AssetSnippet; import com.google.api.services.youtubePartner.model.ContentOwnerListResponse; import com.google.api.services.youtubePartner.model.Metadata; import java.io.IOException; import java.util.Arrays; import java.util.Collections; import java.util.List; /** * This sample demonstrates how to create and use asset labels to categorize * and search for items in your asset library. */ public class AssetLabels { private static YouTubePartner youtubePartner; public static void main(String[] args) { List<String> scopes = Arrays.asList( "https://www.googleapis.com/auth/youtube", "https://www.googleapis.com/auth/youtubepartner"); try { Credential credential = Auth.authorize(scopes, "assetlabels"); youtubePartner = new YouTubePartner.Builder(Auth.HTTP_TRANSPORT, Auth.JSON_FACTORY, credential) .setApplicationName("youtube-cmdline-assetlabels-sample") .build(); String contentOwnerId = getContentOwnerId(youtubePartner); System.out.println("Authenticated as CMS user ID '" + contentOwnerId + "'."); String assetLabelName = createAssetLabel(youtubePartner, contentOwnerId, "label1"); listAssetLabels(youtubePartner, contentOwnerId); Asset asset1 = createAsset(youtubePartner, contentOwnerId, "asset1"); System.out.println("Created new asset ID '" + asset1.getId() + "'."); asset1 = updateAsset(youtubePartner, contentOwnerId, asset1, Arrays.asList(assetLabelName, "label3")); System.out.println("Added asset labels '" + asset1.getLabel().get(0) + " " + asset1.getLabel().get(1) + "' to '" + asset1.getId() + "'."); Asset asset2 = createAsset(youtubePartner, contentOwnerId, "asset2"); System.out.println("Created new asset ID '" + asset2.getId() + "'."); asset2 = updateAsset(youtubePartner, contentOwnerId, asset2, Collections.singletonList("label3")); System.out.println("Added asset label '" + asset2.getLabel().get(0) + "' to '" + asset2.getId() + "'."); listAssetLabels(youtubePartner, contentOwnerId); // AssetSearch may not return expected results immediately due to indexing delay. searchAsset(youtubePartner, contentOwnerId, "label1, label3", null); searchAsset(youtubePartner, contentOwnerId, "label1, label3", true); System.out.println("All done!"); } catch (GoogleJsonResponseException e) { System.err.println("GoogleJsonResponseException code: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); e.printStackTrace(); } catch (IOException e) { System.err.println("IOException: " + e.getMessage()); e.printStackTrace(); } catch (Throwable t) { System.err.println("Throwable: " + t.getMessage()); t.printStackTrace(); } } private static String getContentOwnerId(YouTubePartner youtubePartner) throws IOException { ContentOwnerListResponse response = youtubePartner.contentOwners() .list() .setFetchMine(true) .execute(); return response.getItems().get(0).getId(); } private static String createAssetLabel(YouTubePartner youtubePartner, String contentOwnerId, String labelName) throws IOException { AssetLabel label = new AssetLabel(); label.setLabelName(labelName); try { AssetLabel response = youtubePartner.assetLabels() .insert(label) .setOnBehalfOfContentOwner(contentOwnerId) .execute(); System.out.println("Created new asset label '" + response.getLabelName() + "'."); return response.getLabelName(); } catch (GoogleJsonResponseException e) { if (e.getStatusCode() == 409) { System.err.println("Asset label '" + labelName + "' already exists."); return labelName; } throw e; } } private static void listAssetLabels(YouTubePartner youtubePartner, String contentOwnerId) throws IOException { AssetLabelListResponse response = youtubePartner.assetLabels() .list() .setOnBehalfOfContentOwner(contentOwnerId) .execute(); List<AssetLabel> labels = response.getItems(); if (labels != null) { for (AssetLabel label : labels) { System.out.println("Found asset label '" + label.getLabelName() + "'."); } } } private static Asset createAsset(YouTubePartner youtubePartner, String contentOwnerId, String title) throws IOException { Metadata metadata = new Metadata(); metadata.setTitle(title); Asset asset = new Asset(); asset.setType("web"); asset.setMetadata(metadata); return youtubePartner.assets() .insert(asset) .setOnBehalfOfContentOwner(contentOwnerId) .execute(); } private static Asset updateAsset(YouTubePartner youtubePartner, String contentOwnerId, Asset asset, List<String> labels) throws IOException { asset.setLabel(labels); return youtubePartner.assets() .update(asset.getId(), asset) .setOnBehalfOfContentOwner(contentOwnerId) .execute(); } private static void searchAsset(YouTubePartner youtubePartner, String contentOwnerId, String labels, Boolean includeAnyLabel) throws IOException { YouTubePartner.AssetSearch.List request = youtubePartner.assetSearch() .list() .setOnBehalfOfContentOwner(contentOwnerId) .setLabels(labels); if (includeAnyLabel != null) { request.setIncludeAnyProvidedlabel(includeAnyLabel); } AssetSearchResponse response = request.execute(); List<AssetSnippet> items = response.getItems(); if (items != null) { for (AssetSnippet snippet : items) { System.out.println("Found asset ID '" + snippet.getId() + "'."); } } } }
Tworzenie zasobu, przesyłanie filmu i zgłaszanie do niego roszczenia
Poniższy przykładowy kod wykonuje serię wywołań interfejsu API, aby utworzyć zasób i ustawić jego własność, przesłać film, zgłosić roszczenie do filmu jako dopasowanego do zasobu oraz ustawić opcje reklamowe filmu.
/* * Copyright (c) 2026 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except * in compliance with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package com.google.api.services.samples.youtube.cmdline.partner; import com.google.api.client.auth.oauth2.Credential; import com.google.api.client.googleapis.json.GoogleJsonResponseException; import com.google.api.client.googleapis.media.MediaHttpUploader; import com.google.api.client.http.FileContent; import com.google.api.services.samples.youtube.cmdline.Auth; import com.google.api.services.youtube.YouTube; import com.google.api.services.youtube.model.Video; import com.google.api.services.youtube.model.VideoSnippet; import com.google.api.services.youtube.model.VideoStatus; import com.google.api.services.youtubePartner.YouTubePartner; import com.google.api.services.youtubePartner.model.Asset; import com.google.api.services.youtubePartner.model.Claim; import com.google.api.services.youtubePartner.model.ContentOwnerListResponse; import com.google.api.services.youtubePartner.model.Metadata; import com.google.api.services.youtubePartner.model.Policy; import com.google.api.services.youtubePartner.model.PolicyRule; import com.google.api.services.youtubePartner.model.RightsOwnership; import com.google.api.services.youtubePartner.model.TerritoryOwners; import com.google.api.services.youtubePartner.model.VideoAdvertisingOption; import java.io.File; import java.io.IOException; import java.util.Arrays; import java.util.Collections; import java.util.List; /** * This sample creates an asset, sets ownership for that asset, uploads a video * to a managed channel, claims the video as a match of the asset, and enables * TrueView instream ads for the video. */ public class UploadMonetizeVideo { private static YouTube youtube; private static YouTubePartner youtubePartner; private static final String VIDEO_FILE_FORMAT = "video/*"; private static final String SAMPLE_VIDEO_FILENAME = "sample-video.mp4"; private static final String MANAGED_CHANNEL_ID = "UC_ENTER_MANAGED_CHANNEL_ID"; public static void main(String[] args) { List<String> scopes = Arrays.asList( "https://www.googleapis.com/auth/youtube", "https://www.googleapis.com/auth/youtubepartner"); try { Credential credential = Auth.authorize(scopes, "uploadmonetizevideo"); youtube = new YouTube.Builder(Auth.HTTP_TRANSPORT, Auth.JSON_FACTORY, credential) .setApplicationName("youtube-cmdline-uploadmonetizevideo-sample") .build(); youtubePartner = new YouTubePartner.Builder(Auth.HTTP_TRANSPORT, Auth.JSON_FACTORY, credential) .setApplicationName("youtube-cmdline-uploadmonetizevideo-sample") .build(); String contentOwnerId = getContentOwnerId(youtubePartner); System.out.println("Authenticated as content owner ID '" + contentOwnerId + "'."); String title = "Test Upload and Claim Title"; String description = "Test Upload and Claim Description"; String videoId = uploadVideo(youtube, contentOwnerId, MANAGED_CHANNEL_ID, title, description); System.out.println("Successfully uploaded video ID '" + videoId + "'."); String assetId = createAsset(youtubePartner, contentOwnerId, title, description); System.out.println("Created new asset ID '" + assetId + "'."); setAssetOwnership(youtubePartner, contentOwnerId, assetId); System.out.println("Successfully set asset ownership."); String claimId = claimVideo(youtubePartner, contentOwnerId, assetId, videoId, null); System.out.println("Created new claim ID '" + claimId + "'."); setAdvertisingOptions(youtubePartner, contentOwnerId, videoId); System.out.println("Successfully set advertising options."); System.out.println("All done!"); } catch (GoogleJsonResponseException e) { System.err.println("GoogleJsonResponseException code: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); e.printStackTrace(); } catch (IOException e) { System.err.println("IOException: " + e.getMessage()); e.printStackTrace(); } catch (Throwable t) { System.err.println("Throwable: " + t.getMessage()); t.printStackTrace(); } } private static String getContentOwnerId(YouTubePartner youtubePartner) throws IOException { ContentOwnerListResponse response = youtubePartner.contentOwners() .list() .setFetchMine(true) .execute(); return response.getItems().get(0).getId(); } private static String uploadVideo(YouTube youtube, String contentOwnerId, String channelId, String title, String description) throws IOException { Video videoObjectDefiningMetadata = new Video(); VideoStatus status = new VideoStatus(); status.setPrivacyStatus("public"); videoObjectDefiningMetadata.setStatus(status); VideoSnippet snippet = new VideoSnippet(); snippet.setTitle(title); snippet.setDescription(description); snippet.setCategoryId("22"); videoObjectDefiningMetadata.setSnippet(snippet); File videoFile = new File(SAMPLE_VIDEO_FILENAME); FileContent mediaContent = new FileContent(VIDEO_FILE_FORMAT, videoFile); YouTube.Videos.Insert videoInsert = youtube.videos() .insert("snippet,status", videoObjectDefiningMetadata, mediaContent) .setOnBehalfOfContentOwner(contentOwnerId) .setOnBehalfOfContentOwnerChannel(channelId); MediaHttpUploader uploader = videoInsert.getMediaHttpUploader(); uploader.setDirectUploadEnabled(false); Video returnedVideo = videoInsert.execute(); return returnedVideo.getId(); } private static String createAsset(YouTubePartner youtubePartner, String contentOwnerId, String title, String description) throws IOException { Metadata metadata = new Metadata(); metadata.setTitle(title); metadata.setDescription(description); Asset asset = new Asset(); asset.setType("web"); asset.setMetadata(metadata); Asset insertedAsset = youtubePartner.assets() .insert(asset) .setOnBehalfOfContentOwner(contentOwnerId) .execute(); return insertedAsset.getId(); } private static void setAssetOwnership(YouTubePartner youtubePartner, String contentOwnerId, String assetId) throws IOException { TerritoryOwners territoryOwners = new TerritoryOwners(); territoryOwners.setOwner(contentOwnerId); territoryOwners.setRatio(100.0); territoryOwners.setType("exclude"); territoryOwners.setTerritories(Collections.emptyList()); RightsOwnership ownership = new RightsOwnership(); ownership.setGeneral(Collections.singletonList(territoryOwners)); youtubePartner.ownership() .update(assetId, ownership) .setOnBehalfOfContentOwner(contentOwnerId) .execute(); } private static String claimVideo(YouTubePartner youtubePartner, String contentOwnerId, String assetId, String videoId, String policyId) throws IOException { Policy policy = new Policy(); if (policyId != null && !policyId.isEmpty()) { policy.setId(policyId); } else { PolicyRule rule = new PolicyRule(); rule.setAction("monetize"); policy.setRules(Collections.singletonList(rule)); } Claim claim = new Claim(); claim.setAssetId(assetId); claim.setVideoId(videoId); claim.setPolicy(policy); claim.setContentType("audiovisual"); Claim insertedClaim = youtubePartner.claims() .insert(claim) .setOnBehalfOfContentOwner(contentOwnerId) .execute(); return insertedClaim.getId(); } private static void setAdvertisingOptions(YouTubePartner youtubePartner, String contentOwnerId, String videoId) throws IOException { VideoAdvertisingOption advertisingOption = new VideoAdvertisingOption(); advertisingOption.setAdFormats(Collections.singletonList("trueview_instream")); youtubePartner.videoAdvertisingOptions() .update(videoId, advertisingOption) .setOnBehalfOfContentOwner(contentOwnerId) .execute(); } }