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