स्ट्रक्चर्ड डेटा फ़ाइल अपलोड करना

Display & Video 360 API का इस्तेमाल करके, स्ट्रक्चर्ड डेटा फ़ाइलें अपलोड की जा सकती हैं. इससे, YouTube संसाधनों के साथ-साथ अन्य संसाधनों को प्रोग्राम के हिसाब से और एक साथ बनाया और अपडेट किया जा सकता है. इस पेज पर, एपीआई का इस्तेमाल करके स्ट्रक्चर्ड डेटा फ़ाइल तैयार करने और अपलोड करने का तरीका बताया गया है.

विज्ञापन देने वाले हर व्यक्ति या कंपनी के आईडी के लिए, Google Cloud प्रोजेक्ट से एक दिन में सिर्फ़ 30 स्ट्रक्चर्ड डेटा फ़ाइलें अपलोड की जा सकती हैं.

अपलोड करने के लिए स्ट्रक्चर्ड डेटा फ़ाइल तैयार करना

अपलोड की गई स्ट्रक्चर्ड डेटा फ़ाइलें, हाल ही में डाउनलोड की गई स्ट्रक्चर्ड डेटा फ़ाइलों के बदले गए वर्शन होने चाहिए. ये फ़ाइलें, एक ही फ़ाइल टाइप की होनी चाहिए और एक ही विज्ञापन देने वाले व्यक्ति या कंपनी की होनी चाहिए. डाउनलोड की गई स्ट्रक्चर्ड डेटा फ़ाइल को अपलोड करने के लिए तैयार करें. इसके लिए, ये बदलाव करें:

• आपको जो भी नए संसाधन बनाने हैं उनके लिए एंट्री जोड़ें.
• उन संसाधनों के लिए मौजूदा प्रविष्टियां अपडेट करें जिन्हें आपको अपडेट करना है.
• फ़ाइल का साइज़ कम करने, प्रोसेस होने में लगने वाला समय कम करने, और अनचाहे अपडेट की संभावना को कम करने के लिए, ऐसी सभी एंट्री हटाएं जो नई या अपडेट नहीं की गई हैं.

अहम जानकारी: अपलोड करने के लिए एसडीएफ़ तैयार करते समय, हाल ही में डाउनलोड किए गए एसडीएफ़ का इस्तेमाल करें. एसडीएफ़ डाउनलोड करने के बाद, जिन संसाधनों में बदलाव किया गया है वे फ़ाइल अपलोड करने पर अपडेट नहीं हो सकते.

फ़ाइल अपलोड करने से पहले, इनकी पुष्टि करें:

• यह फ़ाइल CSV फ़ाइल है.
• फ़ाइल में मौजूद सभी एंट्री, विज्ञापन देने वाले एक ही पैरंट खाते के संसाधनों के लिए होती हैं.
• फ़ाइल में 10,000 से ज़्यादा एंट्री नहीं होनी चाहिए.

फ़ाइल अपलोड करें

advertisers.sdfuploadtasks.upload तरीके का इस्तेमाल करके, स्ट्रक्चर्ड डेटा फ़ाइल अपलोड करें. इस अनुरोध से, एसडीएफ़ अपलोड करने का टास्क Operation बनाया जाता है. यह लंबे समय तक चलने वाली प्रोसेस, अपलोड की गई फ़ाइल को प्रोसेस करती है. साथ ही, फ़ाइल के कॉन्टेंट के आधार पर संसाधन बनाती है और उन्हें अपडेट करती है. इसके अलावा, यह ऐसी फ़ाइलें जनरेट करती है जिनमें अपडेट के सफल और असफल होने की जानकारी होती है.

स्ट्रक्चर्ड डेटा फ़ाइल अपलोड करने और उससे मिले Operation को वापस पाने का तरीका यहां बताया गया है:

चेतावनी: विज्ञापन देने वाला व्यक्ति या कंपनी, advertisers.sdfuploadtasks.upload तरीके का इस्तेमाल करके, हर दिन सिर्फ़ 30 बार कॉल कर सकती है. ऐसा Google Cloud प्रोजेक्ट के ज़रिए किया जा सकता है. अमेरिका के पैसिफ़िक टाइमज़ोन (पीएसटी) के हिसाब से, दिन की शुरुआत आधी रात से होती है. अगर किसी तरीके से पुष्टि कराने का अनुरोध पूरा नहीं होता है, तो उसे आपके कोटा में नहीं गिना जाता.

# Import the object used as the media body for the upload request.
from apiclient.http import MediaFileUpload

# Provide the parent advertiser ID for the resources in the SDF.
# The ID value must be a str and not an int.
advertiser_id = advertiser-id

# Provide the filename and local path to the media file.
sdf_filename = sdf-filename
sdf_path = sdf-path

# Create the request body.
body = {
  'filename': sdf_filename,
  'advertiserId': advertiser_id
}

# Create the upload object and use a default MIME type if not identified.
media = MediaFileUpload(sdf_path)
if not media.mimetype():
  media = MediaFileUpload(sdf_filename,'application/octet-stream')

# Upload the structured data file.
upload_response = service.advertisers().sdfuploadtasks().upload(
  advertiserId=advertiser_id,
  body=body,
  media_body=media
).execute()

# Print resulting Operation name.
print(f'SDF was successfully uploaded. Operation {upload_response["name"]} was '
       'created to process the uploaded file.')