Google Ads API की मदद से, YouTube वीडियो को अपने Google Ads खाते से लिंक किया जा सकता है. इस गाइड में, एपीआई का इस्तेमाल करके अपने खाते में लिंक जोड़ने और हटाने का तरीका बताया गया है.
वीडियो लिंक करना
वीडियो को आपके खाते से दो तरीकों से लिंक किया जा सकता है. यह इस बात पर निर्भर करता है कि प्रोसेस किसने शुरू की है:
- आपने अपने खाते से किसी वीडियो को लिंक करने का अनुरोध किया हो. इस मामले में, आपको क्रिएटर को एक अनुरोध भेजना होगा. वीडियो को लिंक करने के लिए, क्रिएटर को यह अनुरोध स्वीकार करना होगा. अनुरोध स्वीकार होने से पहले, उसे वापस लिया जा सकता है. साथ ही, अनुरोध स्वीकार होने के बाद, लिंक किए गए वीडियो को हटाया जा सकता है.
- वीडियो का क्रिएटर, अपने वीडियो को आपके 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 ब्रैंड चैनल का आईडी दिया जा सकता है, ताकि क्रिएटर्स आपके ब्रैंड को समझ सकें.
DataLink का status सेट नहीं किया जाना चाहिए. एपीआई कॉल पूरा होने पर, 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 वीडियो का आईडी और चैनल आईडी शामिल है:
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 |
यह गड़बड़ी तब दिखती है, जब वीडियो के लिए डेटा लिंक पहले से मौजूद हो. |