YouTube को लिंक करना

Google Ads API की मदद से, YouTube वीडियो को अपने Google Ads खाते से लिंक किया जा सकता है. इस गाइड में, एपीआई का इस्तेमाल करके अपने खाते में लिंक जोड़ने और हटाने का तरीका बताया गया है.

वीडियो को आपके खाते से दो तरीकों से लिंक किया जा सकता है. यह इस बात पर निर्भर करता है कि प्रोसेस किसने शुरू की है. ये दो तरीके हैं:

  1. आपने अपने खाते से किसी वीडियो को लिंक करने का अनुरोध किया हो. इस स्थिति में, आपको क्रिएटर को एक अनुरोध भेजना होगा. क्रिएटर को यह अनुरोध स्वीकार करना होगा, ताकि उसके वीडियो को लिंक किया जा सके. अनुरोध स्वीकार किए जाने से पहले, उसे रद्द किया जा सकता है. साथ ही, अनुरोध स्वीकार किए जाने के बाद, लिंक किए गए वीडियो को हटाया जा सकता है.
  2. वीडियो का क्रिएटर, अपने वीडियो को आपके Google Ads खाते से लिंक करने का अनुरोध करता है. इसके बाद, आपके पास उनके अनुरोध को स्वीकार या अस्वीकार करने का विकल्प होता है.

हर स्थिति में, इन तरीकों का इस्तेमाल किया जाता है:

स्थिति कार्रवाई टिप्पणियां
पहली स्थिति YouTube API से वीडियो की जानकारी पाना YouTube API का इस्तेमाल करके, channel_id का पता लगाएं. इस पते पर, वीडियो लिंक करने का अनुरोध भेजा जा सकता है. साथ ही, video_id का पता लगाएं. यह उस वीडियो का आईडी होता है जिसे आपको लिंक करना है. video_id, YouTube वीडियो के यूआरएल में मौजूद 11 वर्णों वाला स्ट्रिंग होता है. उदाहरण के लिए, www.youtube.com/watch?v=VIDEO_ID में मौजूद v पैरामीटर या youtu.be/VIDEO_ID में मौजूद पाथ.
खाते को जोड़ने का अनुरोध करें लिंक करने का अनुरोध करने के लिए, DataLinkService.CreateDataLink तरीके का इस्तेमाल करें. इसमें youtube_video.channel_id और youtube_video.video_id, दोनों की जानकारी दें. इससे वीडियो और उससे जुड़े चैनल की पहचान की जा सकेगी. v24 से, youtube_link_metadata.brand_channel_id को भी तय किया जा सकता है. इससे लिंक किए गए YouTube ब्रैंड चैनल का आईडी दिया जा सकता है, ताकि क्रिएटर्स आपके ब्रैंड को समझ सकें. status की DataLink वैल्यू सेट नहीं की जानी चाहिए. एपीआई कॉल पूरा होने के बाद, Google Ads API सर्वर इसे REQUESTED पर सेट कर देगा.
अनुरोध की स्थिति देखना data_link रिसॉर्स के बारे में क्वेरी करने और उसके status की जांच करने के लिए, GoogleAdsService.SearchStream या GoogleAdsService.Search का इस्तेमाल करें.
अनुरोध रद्द करना DataLinkService.UpdateDataLink तरीके का इस्तेमाल करके, लिंक करने के अनुरोध को रद्द करें. इसके लिए, DataLink के status को REQUESTED से बदलकर REVOKED करें.
लिंक हटाना लिंक किए गए वीडियो को हटाने के लिए, DataLinkService.RemoveDataLink का इस्तेमाल करें.
Scenario 2 न्योता वापस पाना data_link संसाधन के बारे में क्वेरी करने के लिए, GoogleAdsService.Search या GoogleAdsService.SearchStream का इस्तेमाल करें. status = PENDING_APPROVAL के लिए फ़िल्टर करें, ताकि आपको खाता लिंक करने के अनुरोध मिल सकें. इन अनुरोधों को स्वीकार या अस्वीकार किया जा सकता है.
खाता लिंक करने का अनुरोध स्वीकार या अस्वीकार करना अनुरोध को स्वीकार करने के लिए DataLink का स्टेटस ENABLED पर सेट करें या अनुरोध को अस्वीकार करने के लिए REJECTED पर सेट करें. इसके लिए, DataLinkService.UpdateDataLink तरीके का इस्तेमाल करें.

लिंक की जानकारी वापस पाना

data_link संसाधन से क्वेरी करने के लिए, GoogleAdsService.Search या GoogleAdsService.SearchStream का इस्तेमाल किया जा सकता है. नीचे दी गई क्वेरी, YouTube वीडियो के लिंक की जानकारी वापस लाती है. इसमें YouTube वीडियो का आईडी और चैनल आईडी शामिल है:

SELECT
  data_link.resource_name,
  data_link.status,
  data_link.youtube_video.video_id,
  data_link.youtube_video.channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'

इस वर्कफ़्लो में, ये सामान्य गड़बड़ियां हो सकती हैं:

गड़बड़ी का कोड स्पष्टीकरण
DataLinkError.PERMISSION_DENIED ग्राहक के पास यह कार्रवाई करने की अनुमति नहीं है.
DataLinkError.YOUTUBE_VIDEO_ID_INVALID वीडियो का लिंक नहीं बनाया जा सका, क्योंकि वीडियो का आईडी अमान्य है.
DataLinkError.INVALID_STATUS यह गड़बड़ी तब दिखती है, जब डेटा लिंक का मौजूदा स्टेटस, अनुरोध की गई कार्रवाई के लिए अमान्य होता है.
DataLinkError.INVALID_UPDATE_STATUS अपडेट के दौरान, स्टेटस में ऐसा बदलाव करने की कोशिश करने पर यह गड़बड़ी दिखती है जो काम नहीं करता. उदाहरण के लिए, सीधे REVOKED से ENABLED पर जाना.
MutateError.RESOURCE_ALREADY_EXISTS यह तब दिखता है, जब वीडियो के लिए डेटा लिंक पहले से मौजूद हो.
पीछे जाएं
प्रॉडक्ट खाते जोड़ना
आगे बढ़ें
स्टेटस बदलें