Следующие примеры кода, использующие клиентскую библиотеку Google API для Java , доступны для YouTube Content ID API .
Примечание: В этих примерах используется сервис YouTubePartner из com.google.apis:google-api-services-youtubePartner . Для загрузки сгенерированных привязок API идентификаторов контента YouTube, необходимых для запуска этих примеров, см. документацию по клиентским библиотекам.
Получить доступ к каналам, управляемым владельцем контента.
В приведенном ниже примере кода вызывается метод channels.list из API данных YouTube для получения списка каналов, управляемых владельцем контента, отправившим запрос к 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); } }
Создавайте, управляйте и используйте метки активов.
Приведённый ниже пример кода выполняет ряд вызовов 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.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() + "'."); } } } }
Создайте ресурс; загрузите и подтвердите права на видео.
Приведенный ниже пример кода выполняет ряд вызовов 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.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(); } }