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 का इस्तेमाल करें. |
|
| Scenario 2 | न्योता वापस पाना | data_link
संसाधन के बारे में क्वेरी करने के लिए, GoogleAdsService.Search
या GoogleAdsService.SearchStream
का इस्तेमाल करें.
status = PENDING_APPROVAL के लिए फ़िल्टर करें, ताकि
खाता लिंक करने के अनुरोधों को स्वीकार या अस्वीकार किया जा सके. |
| खाता लिंक करने का अनुरोध स्वीकार या अस्वीकार करना | DataLink की स्थिति को अपडेट करने के लिए,
DataLinkService.UpdateDataLink तरीके का इस्तेमाल करें. अनुरोध को स्वीकार करने के लिए, 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 |
यह तब दिखता है, जब वीडियो के लिए डेटा लिंक पहले से मौजूद हो. |