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