YouTube को लिंक करना

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

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

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

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

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

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

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

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

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

गड़बड़ी का कोड स्पष्टीकरण
DataLinkError.PERMISSION_DENIED ग्राहक के पास यह कार्रवाई करने की अनुमति नहीं है.
DataLinkError.YOUTUBE_VIDEO_ID_INVALID वीडियो का आईडी अमान्य होने की वजह से, वीडियो लिंक नहीं बनाया जा सका.