YouTube Content ID API için Java için Google API'leri İstemci Kitaplığı'nı kullanan aşağıdaki kod örnekleri mevcuttur.
Not: Bu örnekler, com.google.apis:google-api-services-youtubePartner hizmetinden YouTubePartner hizmetini içe aktarır. Bu örnekleri çalıştırmak için gereken oluşturulmuş YouTube Content ID API bağlamalarını indirmek üzere istemci kitaplıkları dokümanlarına bakın.
İçerik sahibinin yönetilen kanallarını alma
Aşağıdaki kod örneği, API isteğini yapan içerik sahibi tarafından yönetilen kanalların listesini almak için YouTube Data API'nin channels.list yöntemini çağırır.
/* * 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); } }
Öğe etiketleri oluşturma, yönetme ve kullanma
Aşağıdaki kod örneğinde, öğe kitaplığınızdaki öğeleri kategorize etmek ve aramak için öğe etiketlerinin nasıl oluşturulup kullanılacağını gösteren bir dizi API çağrısı yapılmaktadır.
/* * 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() + "'."); } } } }
Öğe oluşturma; video yükleme ve videoyla ilgili hak talebinde bulunma
Aşağıdaki kod örneğinde, bir öğe oluşturmak ve bu öğenin sahipliğini ayarlamak, video yüklemek, videonun öğeyle eşleştiğini iddia etmek ve video için reklam seçeneklerini ayarlamak üzere bir dizi API çağrısı yapılır.
/* * 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(); } }