สร้างและเข้าถึงรายงานที่ตั้งเวลาไว้

คุณสร้างและตั้งเวลารายงานได้โดยใช้ UI ของ Google Display & Video 360 หรือ API เช่น ผู้ใช้ปลายทางสามารถตั้งค่ารายงานรายวันซึ่งแสดงการแสดงผลของเมื่อวาน หรือรายงานรายเดือนซึ่งแสดงค่าใช้จ่ายทั้งหมด

หมายเหตุ: การเข้าถึงรายงานโดยใช้วิธีนี้จะอนุญาตให้ดึงข้อมูลรายงานแบบอ่านอย่างเดียว ซึ่งตั้งค่าไว้แล้วใน UI ของ Display & Video 360 เท่านั้น โดยไม่ อนุญาตให้แก้ไขรายงานที่มีอยู่หรือสร้างรายงานใหม่

สร้างรายงานที่ตั้งเวลาไว้

สร้างรายงานที่ตั้งเวลาไว้ใหม่ในอินเทอร์เฟซการรายงานของ Display & Video 360 หรือ ด้วยเมธอด queries.create API ดูรายละเอียดทั้งหมดเกี่ยวกับฟังก์ชันการรายงานของ Display & Video 360 และวิธีสร้างรายงานใหม่ได้ที่เว็บไซต์สนับสนุนของ Display & Video 360

คุณสามารถตั้งเวลารายงานได้ในตอนสร้างโดยใช้ฟิลด์ Repeats ใน UI และฟิลด์ schedule ใน API ควรตั้งค่าช่องเหล่านี้เป็น ช่วงเวลาที่เหมาะสม

หลังจากตั้งค่าฟิลด์ที่เหมาะสมแล้ว รายงานนี้จะทํางานตามกําหนดการนั้น และ รายงานที่สร้างขึ้นจะพร้อมให้ดาวน์โหลด

เข้าถึงรายงานที่ตั้งเวลาไว้

ระบบจะสร้างรายงานที่ตั้งเวลาไว้เป็นไฟล์ CSV อย่างง่ายและจัดเก็บไว้โดยอัตโนมัติ และปลอดภัยใน Google Cloud Storage อย่างไรก็ตาม คุณจะเข้าถึง Bucket ของ Google Cloud Storage ที่มีไฟล์เหล่านี้โดยตรงไม่ได้ แต่คุณสามารถดาวน์โหลดไฟล์จาก UI ของ Display & Video 360 ด้วยตนเอง หรือเรียกข้อมูลแบบเป็นโปรแกรมโดยใช้URL ที่ให้สิทธิ์ล่วงหน้าซึ่งได้จาก API

ตัวอย่างการใช้ API เพื่อดาวน์โหลดไฟล์รายงานมีดังนี้ ในตัวอย่างนี้ ระบบจะใช้ queries.reports.list กับพารามิเตอร์ orderBy เพื่อดึงข้อมูลรายงานล่าสุดภายใต้การค้นหา จากนั้นระบบจะใช้ฟิลด์ Report.reportMetadata.googleCloudStoragePath เพื่อค้นหาไฟล์รายงานและดาวน์โหลดเนื้อหาไปยังไฟล์ CSV ในเครื่อง

Java

การนำเข้าที่จำเป็น

import com.google.api.client.googleapis.media.MediaHttpDownloader;
import com.google.api.client.googleapis.util.Utils;
import com.google.api.client.http.GenericUrl;
import com.google.api.services.doubleclickbidmanager.DoubleClickBidManager;
import com.google.api.services.doubleclickbidmanager.model.ListReportsResponse;
import com.google.api.services.doubleclickbidmanager.model.Report;
import java.io.FileOutputStream;
import java.io.OutputStream;

ตัวอย่างโค้ด

long queryId = query-id;

// Call the API, listing the reports under the given queryId from most to
// least recent.
ListReportsResponse reportListResponse =
    service
        .queries()
        .reports()
        .list(queryId)
        .setOrderBy("key.reportId desc")
        .execute();

// Iterate over returned reports, stopping once finding a report that
// finished generating successfully.
Report mostRecentReport = null;
if (reportListResponse.getReports() != null) {
  for (Report report : reportListResponse.getReports()) {
    if (report.getMetadata().getStatus().getState().equals("DONE")) {
      mostRecentReport = report;
      break;
    }
  }
} else {
  System.out.format("No reports exist for query Id %s.\n", queryId);
}

// Download report file of most recent finished report found.
if (mostRecentReport != null) {
  // Retrieve GCS URL from report object.
  GenericUrl reportUrl =
      new GenericUrl(mostRecentReport.getMetadata().getGoogleCloudStoragePath());

  // Build filename.
  String filename =
      mostRecentReport.getKey().getQueryId() + "_"
          + mostRecentReport.getKey().getReportId() + ".csv";

  // Download the report file.
  try (OutputStream output = new FileOutputStream(filename)) {
    MediaHttpDownloader downloader =
        new MediaHttpDownloader(Utils.getDefaultTransport(), null);
    downloader.download(reportUrl, output);
  }
  System.out.format("Download of file %s complete.\n", filename);
} else {
  System.out.format(
      "There are no completed report files to download for query Id %s.\n",
      queryId);
}

Python

การนำเข้าที่จำเป็น

from contextlib import closing
from six.moves.urllib.request import urlopen

ตัวอย่างโค้ด

query_id = query-id

# Call the API, listing the reports under the given queryId from most to
# least recent.
response = service.queries().reports().list(queryId=query_id, orderBy="key.reportId desc").execute()

# Iterate over returned reports, stopping once finding a report that
# finished generating successfully.
most_recent_report = None
if response['reports']:
  for report in response['reports']:
    if report['metadata']['status']['state'] == 'DONE':
      most_recent_report = report
      break
else:
  print('No reports exist for query Id %s.' % query_id)

# Download report file of most recent finished report found.
if most_recent_report != None:
  # Retrieve GCS URL from report object.
  report_url = most_recent_report['metadata']['googleCloudStoragePath']

  # Build filename.
  output_file = '%s_%s.csv' % (report['key']['queryId'], report['key']['reportId'])

  # Download the report file.
  with open(output_file, 'wb') as output:
    with closing(urlopen(report_url)) as url:
      output.write(url.read())
  print('Download of file %s complete.' % output_file)
else:
  print('There are no completed report files to download for query Id %s.' % query_id)

PHP

$queryId = query-id;

// Call the API, listing the reports under the given queryId from most to
// least recent.
$optParams = array('orderBy' => "key.reportId desc");
$response = $service->queries_reports->listQueriesReports($queryId, $optParams);

// Iterate over returned reports, stopping once finding a report that
// finished generating successfully.
$mostRecentReport = null;
if (!empty($response->getReports())) {
  foreach ($response->getReports() as $report) {
    if ($report->metadata->status->state == "DONE") {
      $mostRecentReport = $report;
      break;
    }
  }
} else {
  printf('<p>No reports exist for query ID %s.</p>', $queryId);
}

// Download report file of most recent finished report found.
if ($mostRecentReport != null) {
  // Build filename.
  $filename = $mostRecentReport->key->queryId . '_' . $mostRecentReport->key->reportId . '.csv';

  // Download the report file.
  file_put_contents($filename, fopen($mostRecentReport->metadata->googleCloudStoragePath, 'r'));
  printf('<p>Download of file %s complete.</p>', $filename);
} else {
  printf('<p>There are no completed report files to download for query Id %s.</p>', $queryId);
}