স্ট্রাকচার্ড ডেটা ফাইল আপলোড করুন

আপনি Display & Video 360 API ব্যবহার করে স্ট্রাকচার্ড ডেটা ফাইল আপলোড করে প্রোগ্রামগতভাবে এবং প্রচুর পরিমাণে YouTube সংস্থান সহ সংস্থানগুলি তৈরি এবং আপডেট করতে পারেন৷ এই পৃষ্ঠাটি API ব্যবহার করে একটি স্ট্রাকচার্ড ডেটা ফাইল তৈরি এবং আপলোড করার বিষয়ে আলোচনা করে।

একটি Google ক্লাউড প্রকল্পের দ্বারা বিজ্ঞাপনদাতার আইডি প্রতি মাত্র ত্রিশটি স্ট্রাকচার্ড ডেটা ফাইল একদিনে আপলোড করা যেতে পারে৷

আপলোড করার জন্য একটি স্ট্রাকচার্ড ডেটা ফাইল প্রস্তুত করুন

আপলোড করা স্ট্রাকচার্ড ডেটা ফাইলগুলিকে একই ধরনের ফাইলের এবং একই বিজ্ঞাপনদাতার কাছ থেকে সম্প্রতি ডাউনলোড করা স্ট্রাকচার্ড ডেটা ফাইলগুলির পরিবর্তন করা উচিত৷ নিম্নলিখিত আপডেটগুলি করে আপলোডের জন্য ডাউনলোড করা স্ট্রাকচার্ড ডেটা ফাইল প্রস্তুত করুন:

• আপনি যে নতুন সম্পদ তৈরি করতে চান তার জন্য এন্ট্রি যোগ করুন।
• আপনি যে সংস্থানগুলি আপডেট করতে চান তার জন্য বিদ্যমান কোনো এন্ট্রি আপডেট করুন।
• ফাইলের আকার কমাতে, প্রক্রিয়াকরণের সময়কে গতি বাড়াতে এবং অনিচ্ছাকৃত আপডেটের সম্ভাবনা দূর করার জন্য নতুন বা আপডেট করা নয় এমন কোনো এন্ট্রি সরান।

টিপ: আপলোডের জন্য একটি SDF প্রস্তুত করার সময় সম্প্রতি ডাউনলোড করা একটি SDF ব্যবহার করুন৷ SDF ডাউনলোড হওয়ার পর থেকে সংশোধিত সম্পদগুলি ফাইল আপলোড করার সময় সফলভাবে আপডেট নাও হতে পারে৷

ফাইল আপলোড করার আগে নিম্নলিখিত যাচাই করুন:

• ফাইলটি একটি CSV ফাইল।
• ফাইলের সমস্ত এন্ট্রি একই অভিভাবক বিজ্ঞাপনদাতার অধীনে সম্পদের জন্য।

একটি ফাইল আপলোড করুন

advertisers.sdfuploadtasks.upload পদ্ধতি ব্যবহার করে একটি স্ট্রাকচার্ড ডেটা ফাইল আপলোড করুন। এই অনুরোধটি একটি SDF আপলোড টাস্ক Operation তৈরি করে। এই দীর্ঘমেয়াদী অপারেশন আপলোড করা ফাইলটি প্রক্রিয়া করে, ফাইলের বিষয়বস্তুর উপর ভিত্তি করে সংস্থান তৈরি করে এবং আপডেট করে এবং ফলাফল ফাইল তৈরি করে যা সফল এবং ব্যর্থ আপডেটের তালিকা করে।

এখানে কিভাবে একটি স্ট্রাকচার্ড ডেটা ফাইল আপলোড করতে হয় এবং ফলাফলের Operation পুনরুদ্ধার করতে হয়:

সতর্কতা: advertisers.sdfuploadtasks.upload পদ্ধতিতে একটি Google ক্লাউড প্রজেক্টের মাধ্যমে প্রতি বিজ্ঞাপনদাতা প্রতি দিনে ত্রিশ বার সফলভাবে কল করা যেতে পারে। দিনটি বিজ্ঞাপনদাতার টাইমজোন দ্বারা সংজ্ঞায়িত করা হয়। পদ্ধতিতে একটি অনুরোধ ব্যর্থ হলে, এটি আপনার কোটার সাথে গণনা করা হবে না।

# 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.')