YouTube को लिंक करना

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

वीडियो लिंक करना

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

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

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

स्थिति	कार्रवाई	टिप्पणियां
पहली स्थिति	YouTube API से वीडियो की जानकारी पाना	YouTube API का इस्तेमाल करके, उस channel_id का पता लगाएं जिसे वीडियो का लिंक भेजने का अनुरोध करना है या उस वीडियो का video_id पता लगाएं जिसे लिंक करना है. video_id को वीडियो के यूआरएल से भी निकाला जा सकता है. इसके लिए, "v=" के बाद के 11 वर्णों को निकालें.
	खाते को जोड़ने का अनुरोध करें	खाते को जोड़ने का अनुरोध करने के लिए, DataLinkService.CreateDataLink तरीके का इस्तेमाल करें. वीडियो से जुड़े चैनल की पहचान करने के लिए, youtube_video.channel_id को वैकल्पिक तौर पर तय किया जा सकता है. DataLink का status सेट नहीं किया जाना चाहिए. एपीआई कॉल पूरा होने के बाद, 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 पर सेट करें या अनुरोध को अस्वीकार करने के लिए DataLink की स्थिति को 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	वीडियो आईडी अमान्य होने की वजह से, वीडियो का लिंक नहीं बनाया जा सका.