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

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

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

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

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

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

টিপস: আপলোডের জন্য SDF প্রস্তুত করার সময় সম্প্রতি ডাউনলোড করা SDF ব্যবহার করুন। SDF ডাউনলোড হওয়ার পর থেকে যে রিসোর্সগুলি পরিবর্তন করা হয়েছে সেগুলি ফাইল আপলোডের সময় সফলভাবে আপডেট নাও হতে পারে।

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

• ফাইলটি একটি CSV ফাইল।
• ফাইলের সমস্ত এন্ট্রি একই মূল বিজ্ঞাপনদাতার অধীনে থাকা সংস্থানগুলির জন্য।
• ফাইলটিতে ১০,০০০ এর বেশি এন্ট্রি নেই।

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

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

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

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

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