videos.insert
एंडपॉइंट की मदद से, अपलोड किए गए सभी वीडियो, निजी मोड में देखे जा सकेंगे. इस पाबंदी को हटाने के लिए,
सभी एपीआई प्रोजेक्ट को
ऑडिट से गुज़रना होगा, ताकि यह पुष्टि की जा सके कि
सेवा की शर्तों का पालन हो रहा है. ज़्यादा जानकारी के लिए, कृपया एपीआई में बदलाव का इतिहास देखें.
YouTube पर वीडियो अपलोड करके, वीडियो का मेटाडेटा सेट किया जा सकता है.
इस तरीके से मीडिया अपलोड किया जा सकता है. अपलोड की गई फ़ाइलों को इन पाबंदियों के मुताबिक होना चाहिए:
- फ़ाइल इससे बड़ी नहीं होनी चाहिए: 256 जीबी
- स्वीकार किए जाने वाले मीडिया MIME टाइप:
video/*
,application/octet-stream
कोटा प्रभाव: इस विधि को किए जाने वाले कॉल का कोटा लागत 1600 इकाइयों है.
इस्तेमाल के सामान्य उदाहरण
अनुरोध करें
एचटीटीपी अनुरोध
POST https://www.googleapis.com/upload/youtube/v3/videos
अनुमति दें
इस अनुरोध के लिए, इनमें से कम से कम एक दायरे की अनुमति लेना ज़रूरी है. पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानें.
दायरा |
---|
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube.force-ssl |
पैरामीटर
इस टेबल में ऐसे पैरामीटर दिए गए हैं जो क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर | ||
---|---|---|
ज़रूरी पैरामीटर | ||
part |
string part कार्रवाई के लिए दो पैरामीटर इस्तेमाल किए जाते हैं. इससे उन प्रॉपर्टी की पहचान होती है जिन्हें 'राइट' ऑपरेशन सेट करता है. साथ ही, उनसे उन प्रॉपर्टी की भी पहचान होती है जिनमें एपीआई से मिलने वाला जवाब शामिल होता है.ध्यान दें कि सभी हिस्सों में ऐसी प्रॉपर्टी शामिल नहीं होती हैं जिन्हें वीडियो डालने या अपडेट करने के दौरान सेट किया जा सकता है. उदाहरण के लिए, statistics ऑब्जेक्ट, आंकड़ों को इकट्ठा करता है. ये आंकड़े, YouTube किसी वीडियो के लिए कैलकुलेट करता है. इसमें ऐसी वैल्यू नहीं होती जिन्हें आप सेट कर सकें या बदल सकें. अगर पैरामीटर वैल्यू में part की जानकारी दी गई है, जिसमें बदले जा सकने वाली वैल्यू मौजूद नहीं हैं, तो part अब भी एपीआई रिस्पॉन्स में शामिल किया जाएगा.नीचे दी गई सूची में part नाम शामिल हैं, जिन्हें पैरामीटर वैल्यू में शामिल किया जा सकता है:
|
|
ज़रूरी पैरामीटर | ||
notifySubscribers |
boolean notifySubscribers पैरामीटर से पता चलता है कि YouTube को, वीडियो के चैनल की सदस्यता लेने वाले उपयोगकर्ताओं को नए वीडियो के बारे में सूचना भेजी जानी चाहिए या नहीं. True के पैरामीटर की वैल्यू से यह पता चलता है कि सदस्यों को नए अपलोड किए गए वीडियो की सूचना दी जाएगी. हालांकि, कई वीडियो अपलोड करने वाले चैनल के मालिक False के लिए मान सेट कर सकते हैं, ताकि चैनल के सदस्यों को हर नए वीडियो के बारे में सूचना न मिले. डिफ़ॉल्ट वैल्यू True है. |
|
onBehalfOfContentOwner |
string इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध की पुष्टि के लिए, किसी YouTube कॉन्टेंट मैनेजमेंट सिस्टम के उपयोगकर्ता की पहचान की गई है. यह उपयोगकर्ता, पैरामीटर वैल्यू में तय किए गए कॉन्टेंट के मालिक की तरफ़ से काम करता है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जो कई अलग-अलग YouTube चैनलों के मालिक हैं और उन्हें प्रबंधित करते हैं. इसकी मदद से कॉन्टेंट के मालिक एक बार पुष्टि कर सकते हैं. साथ ही, अपने सभी वीडियो और चैनल के डेटा को ऐक्सेस कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल नहीं देने होंगे. जिस कॉन्टेंट मैनेजमेंट सिस्टम खाते से उपयोगकर्ता की पुष्टि होती है उसे YouTube के कॉन्टेंट के मालिक से लिंक होना चाहिए. |
|
onBehalfOfContentOwnerChannel |
string इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से किए गए अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwnerChannel पैरामीटर से उस चैनल के YouTube चैनल आईडी का पता चलता है जिसमें वीडियो जोड़ा जा रहा है. यह पैरामीटर तब ज़रूरी होता है, जब कोई अनुरोध onBehalfOfContentOwner पैरामीटर के लिए वैल्यू तय करता है. साथ ही, इसका इस्तेमाल सिर्फ़ उसी पैरामीटर के साथ किया जा सकता है. साथ ही, अनुरोध को ऐसे कॉन्टेंट मैनेजमेंट सिस्टम से लिंक किया जाना चाहिए जो कॉन्टेंट के मालिक से जुड़ा हो और onBehalfOfContentOwner पैरामीटर के बारे में बताता हो. आखिर में, onBehalfOfContentOwnerChannel पैरामीटर की वैल्यू के बारे में बताने वाला चैनल, उस कॉन्टेंट के मालिक से जुड़ा होना चाहिए जिसका onBehalfOfContentOwner पैरामीटर तय करता है.यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जिनके पास अलग-अलग YouTube चैनलों का मालिकाना हक है और उन्हें मैनेज करने का अधिकार है. इसकी मदद से कॉन्टेंट के मालिक एक बार में पुष्टि कर सकते हैं. साथ ही, पैरामीटर की वैल्यू में बताए गए चैनल की तरफ़ से कार्रवाई कर सकते हैं. इसके लिए, हर अलग चैनल के लिए पुष्टि करने के क्रेडेंशियल देने की ज़रूरत नहीं होती. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में वीडियो संसाधन दें. उस संसाधन के लिए:
-
आपके पास इन प्रॉपर्टी के लिए वैल्यू सेट करने का विकल्प है:
snippet.title
snippet.description
snippet.tags[]
snippet.categoryId
snippet.defaultLanguage
localizations.(key)
localizations.(key).title
localizations.(key).description
status.embeddable
status.license
status.privacyStatus
status.publicStatsViewable
status.publishAt
status.selfDeclaredMadeForKids
recordingDetails.locationDescription
(अब इस्तेमाल में नहीं है)recordingDetails.location.latitude
(अब इस्तेमाल में नहीं है)recordingDetails.location.longitude
(अब इस्तेमाल में नहीं है)recordingDetails.recordingDate
जवाब
सफल होने पर, यह तरीका रिस्पॉन्स में वीडियो संसाधन दिखाता है.
उदाहरण
ध्यान दें: हो सकता है कि कोड के ये नमूने, कार्यक्रम की सभी भाषाओं में काम न करते हों. इस्तेमाल की जा सकने वाली भाषाओं की सूची के लिए, क्लाइंट लाइब्रेरी के दस्तावेज़ देखें.
शुरू करें
यह कोड सैंपल, एपीआई केvideos.insert
तरीके को अनुरोध से जुड़े चैनल पर वीडियो अपलोड करने के लिए कहता है.
इस उदाहरण में, Go क्लाइंट लाइब्रेरी का इस्तेमाल किया गया है.
package main import ( "flag" "fmt" "log" "os" "strings" "google.golang.org/api/youtube/v3" ) var ( filename = flag.String("filename", "", "Name of video file to upload") title = flag.String("title", "Test Title", "Video title") description = flag.String("description", "Test Description", "Video description") category = flag.String("category", "22", "Video category") keywords = flag.String("keywords", "", "Comma separated list of video keywords") privacy = flag.String("privacy", "unlisted", "Video privacy status") ) func main() { flag.Parse() if *filename == "" { log.Fatalf("You must provide a filename of a video file to upload") } client := getClient(youtube.YoutubeUploadScope) service, err := youtube.New(client) if err != nil { log.Fatalf("Error creating YouTube client: %v", err) } upload := &youtube.Video{ Snippet: &youtube.VideoSnippet{ Title: *title, Description: *description, CategoryId: *category, }, Status: &youtube.VideoStatus{PrivacyStatus: *privacy}, } // The API returns a 400 Bad Request response if tags is an empty string. if strings.Trim(*keywords, "") != "" { upload.Snippet.Tags = strings.Split(*keywords, ",") } call := service.Videos.Insert("snippet,status", upload) file, err := os.Open(*filename) defer file.Close() if err != nil { log.Fatalf("Error opening %v: %v", *filename, err) } response, err := call.Media(file).Do() handleError(err, "") fmt.Printf("Upload successful! Video ID: %v\n", response.Id) }
.NET
कोड का यह नमूना, अनुरोध से जुड़े चैनल पर वीडियो अपलोड करने के लिए, एपीआई केvideos.insert
तरीके का इस्तेमाल करता है.
इस उदाहरण में .NET क्लाइंट लाइब्रेरी का इस्तेमाल किया गया है.
using System; using System.IO; using System.Reflection; using System.Threading; using System.Threading.Tasks; using Google.Apis.Auth.OAuth2; using Google.Apis.Services; using Google.Apis.Upload; using Google.Apis.Util.Store; using Google.Apis.YouTube.v3; using Google.Apis.YouTube.v3.Data; namespace Google.Apis.YouTube.Samples { /// <summary> /// YouTube Data API v3 sample: upload a video. /// Relies on the Google APIs Client Library for .NET, v1.7.0 or higher. /// See https://developers.google.com/api-client-library/dotnet/get_started /// </summary> internal class UploadVideo { [STAThread] static void Main(string[] args) { Console.WriteLine("YouTube Data API: Upload Video"); Console.WriteLine("=============================="); try { new UploadVideo().Run().Wait(); } catch (AggregateException ex) { foreach (var e in ex.InnerExceptions) { Console.WriteLine("Error: " + e.Message); } } Console.WriteLine("Press any key to continue..."); Console.ReadKey(); } private async Task Run() { UserCredential credential; using (var stream = new FileStream("client_secrets.json", FileMode.Open, FileAccess.Read)) { credential = await GoogleWebAuthorizationBroker.AuthorizeAsync( GoogleClientSecrets.Load(stream).Secrets, // This OAuth 2.0 access scope allows an application to upload files to the // authenticated user's YouTube channel, but doesn't allow other types of access. new[] { YouTubeService.Scope.YoutubeUpload }, "user", CancellationToken.None ); } var youtubeService = new YouTubeService(new BaseClientService.Initializer() { HttpClientInitializer = credential, ApplicationName = Assembly.GetExecutingAssembly().GetName().Name }); var video = new Video(); video.Snippet = new VideoSnippet(); video.Snippet.Title = "Default Video Title"; video.Snippet.Description = "Default Video Description"; video.Snippet.Tags = new string[] { "tag1", "tag2" }; video.Snippet.CategoryId = "22"; // See https://developers.google.com/youtube/v3/docs/videoCategories/list video.Status = new VideoStatus(); video.Status.PrivacyStatus = "unlisted"; // or "private" or "public" var filePath = @"REPLACE_ME.mp4"; // Replace with path to actual movie file. using (var fileStream = new FileStream(filePath, FileMode.Open)) { var videosInsertRequest = youtubeService.Videos.Insert(video, "snippet,status", fileStream, "video/*"); videosInsertRequest.ProgressChanged += videosInsertRequest_ProgressChanged; videosInsertRequest.ResponseReceived += videosInsertRequest_ResponseReceived; await videosInsertRequest.UploadAsync(); } } void videosInsertRequest_ProgressChanged(Google.Apis.Upload.IUploadProgress progress) { switch (progress.Status) { case UploadStatus.Uploading: Console.WriteLine("{0} bytes sent.", progress.BytesSent); break; case UploadStatus.Failed: Console.WriteLine("An error prevented the upload from completing.\n{0}", progress.Exception); break; } } void videosInsertRequest_ResponseReceived(Video video) { Console.WriteLine("Video id '{0}' was successfully uploaded.", video.Id); } } }
Ruby
इस नमूने में एपीआई केvideos.insert
तरीके को अनुरोध के साथ जुड़े चैनल पर वीडियो अपलोड करने के लिए कहा गया है.
इस उदाहरण में Ruby क्लाइंट लाइब्रेरी का इस्तेमाल किया गया है.
#!/usr/bin/ruby require 'rubygems' gem 'google-api-client', '>0.7' require 'google/api_client' require 'google/api_client/client_secrets' require 'google/api_client/auth/file_storage' require 'google/api_client/auth/installed_app' require 'trollop' # A limited OAuth 2 access scope that allows for uploading files, but not other # types of account access. YOUTUBE_UPLOAD_SCOPE = 'https://www.googleapis.com/auth/youtube.upload' YOUTUBE_API_SERVICE_NAME = 'youtube' YOUTUBE_API_VERSION = 'v3' def get_authenticated_service client = Google::APIClient.new( :application_name => $PROGRAM_NAME, :application_version => '1.0.0' ) youtube = client.discovered_api(YOUTUBE_API_SERVICE_NAME, YOUTUBE_API_VERSION) file_storage = Google::APIClient::FileStorage.new("#{$PROGRAM_NAME}-oauth2.json") if file_storage.authorization.nil? client_secrets = Google::APIClient::ClientSecrets.load flow = Google::APIClient::InstalledAppFlow.new( :client_id => client_secrets.client_id, :client_secret => client_secrets.client_secret, :scope => [YOUTUBE_UPLOAD_SCOPE] ) client.authorization = flow.authorize(file_storage) else client.authorization = file_storage.authorization end return client, youtube end def main opts = Trollop::options do opt :file, 'Video file to upload', :type => String opt :title, 'Video title', :default => 'Test Title', :type => String opt :description, 'Video description', :default => 'Test Description', :type => String opt :category_id, 'Numeric video category. See https://developers.google.com/youtube/v3/docs/videoCategories/list', :default => 22, :type => :int opt :keywords, 'Video keywords, comma-separated', :default => '', :type => String opt :privacy_status, 'Video privacy status: public, private, or unlisted', :default => 'public', :type => String end if opts[:file].nil? or not File.file?(opts[:file]) Trollop::die :file, 'does not exist' end client, youtube = get_authenticated_service begin body = { :snippet => { :title => opts[:title], :description => opts[:description], :tags => opts[:keywords].split(','), :categoryId => opts[:category_id], }, :status => { :privacyStatus => opts[:privacy_status] } } videos_insert_response = client.execute!( :api_method => youtube.videos.insert, :body_object => body, :media => Google::APIClient::UploadIO.new(opts[:file], 'video/*'), :parameters => { :uploadType => 'resumable', :part => body.keys.join(',') } ) videos_insert_response.resumable_upload.send_all(client) puts "Video id '#{videos_insert_response.data.id}' was successfully uploaded." rescue Google::APIClient::TransmissionError => e puts e.result.body end end main
गड़बड़ियां
इस टेबल में उन गड़बड़ी के मैसेज के बारे में बताया गया है जो इस तरीके से कॉल करने पर एपीआई मिल सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी का मैसेज दस्तावेज़ देखें.
गड़बड़ी का टाइप | गड़बड़ी की जानकारी | ब्यौरा |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
वीडियो के ब्यौरे की डिफ़ॉल्ट भाषा तय किए बिना, स्थानीय जगह के अनुसार वीडियो की जानकारी जोड़ने का अनुरोध किया गया है. |
badRequest (400) |
invalidCategoryId |
snippet.categoryId प्रॉपर्टी में अमान्य कैटगरी आईडी मौजूद है. काम करने वाली कैटगरी को वापस पाने के लिए, videoCategories.list तरीके का इस्तेमाल करें. |
badRequest (400) |
invalidDescription |
अनुरोध के मेटाडेटा से वीडियो के बारे में गलत जानकारी मिलती है. |
badRequest (400) |
invalidFilename |
Slug हेडर में दिया गया वीडियो फ़ाइल नाम अमान्य है. |
badRequest (400) |
invalidPublishAt |
अनुरोध मेटाडेटा में, पब्लिश करने के लिए शेड्यूल किया गया समय अमान्य है. |
badRequest (400) |
invalidRecordingDetails |
अनुरोध के मेटाडेटा में मौजूद recordingDetails ऑब्जेक्ट, रिकॉर्डिंग की अमान्य जानकारी देता है. |
badRequest (400) |
invalidTags |
अनुरोध के मेटाडेटा से, वीडियो के अमान्य कीवर्ड का पता चलता है. |
badRequest (400) |
invalidTitle |
अनुरोध के मेटाडेटा में वीडियो का शीर्षक अमान्य या खाली है. |
badRequest (400) |
invalidVideoGameRating |
अनुरोध के मेटाडेटा से वीडियो गेम की अमान्य रेटिंग का पता चलता है. |
badRequest (400) |
invalidVideoMetadata |
अनुरोध का मेटाडेटा अमान्य है. |
badRequest (400) |
mediaBodyRequired |
अनुरोध में वीडियो का कॉन्टेंट शामिल नहीं है. |
badRequest (400) |
uploadLimitExceeded |
उपयोगकर्ता ने अपलोड किए जाने वाले वीडियो की सीमा पार कर ली है. |
forbidden (403) |
forbidden |
|
forbidden (403) |
forbiddenLicenseSetting |
अनुरोध, वीडियो के लिए अमान्य लाइसेंस सेट करने की कोशिश करता है. |
forbidden (403) |
forbiddenPrivacySetting |
अनुरोध, वीडियो के लिए अमान्य निजता सेटिंग सेट करने की कोशिश करता है. |
इसे आज़माएं!
इस एपीआई को कॉल करने और एपीआई का अनुरोध और जवाब देखने के लिए, APIs Explorer का इस्तेमाल करें.