Mengupload File Data Terstruktur

Anda dapat membuat dan memperbarui resource, termasuk resource YouTube, secara terprogram dan massal dengan mengupload File Data Terstruktur menggunakan Display & Video 360 API. Halaman ini membahas cara menyiapkan dan mengupload File Data Terstruktur menggunakan API.

Hanya tiga puluh File Data Terstruktur per ID pengiklan yang dapat diupload oleh project Google Cloud dalam sehari.

Menyiapkan File Data Terstruktur untuk diupload

File Data Terstruktur yang diupload harus berupa versi yang diubah dari File Data Terstruktur yang baru-baru ini didownload dengan jenis file yang sama dan dari pengiklan yang sama. Siapkan File Data Terstruktur yang didownload untuk diupload dengan melakukan pembaruan berikut:

• Tambahkan entri untuk setiap resource baru yang ingin Anda buat.
• Perbarui entri yang ada untuk resource yang ingin Anda perbarui.
• Hapus semua entri yang tidak baru atau diperbarui untuk mengurangi ukuran file, mempercepat waktu pemrosesan, dan menghilangkan kemungkinan adanya pembaruan yang tidak disengaja.

Tips: Gunakan SDF yang baru didownload saat menyiapkan SDF untuk diupload. Resource yang telah diubah sejak SDF didownload mungkin tidak berhasil diperbarui saat upload file.

Verifikasi hal berikut sebelum mengupload file:

• File ini adalah file CSV.
• Semua entri dalam file adalah untuk resource di bawah pengiklan induk yang sama.
• File tidak memiliki lebih dari 10.000 entri.

Upload file

Upload File Data Terstruktur menggunakan metode advertisers.sdfuploadtasks.upload. Permintaan ini membuat tugas upload SDF Operation. Operasi yang berjalan lama ini memproses file yang diupload, membuat dan memperbarui resource berdasarkan konten file, serta membuat file hasil yang mencantumkan pembaruan yang berhasil dan gagal.

Berikut cara mengupload File Data Terstruktur dan mengambil Operation yang dihasilkan:

Peringatan: Metode advertisers.sdfuploadtasks.upload hanya dapat berhasil dipanggil tiga puluh kali per hari per pengiklan oleh project Google Cloud dalam sehari. Hari dimulai pada tengah malam di zona waktu Pasifik AS (PST). Jika permintaan ke metode gagal, permintaan tersebut tidak akan mengurangi kuota Anda.

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