บริการขั้นสูงของ Looker Studio

หากเครื่องมือเชื่อมต่อดึงข้อมูลจาก BigQuery คุณจะใช้บริการขั้นสูงของ Looker Studio เพื่อเพิ่มประสิทธิภาพเครื่องมือเชื่อมต่อได้ คุณเพียงแค่ระบุการกำหนดค่าการค้นหา แล้ว Looker Studio จะดึงข้อมูลและสคีมาให้คุณแทนที่จะเรียกใช้ BigQuery API โดยตรง

วิธีการทำงาน

เครื่องมือเชื่อมต่อจากชุมชนที่ใช้บริการขั้นสูงของ Looker Studio จะทำงานคล้ายกับเครื่องมือเชื่อมต่อปกติ

ความแตกต่างที่สำคัญคือการตอบกลับที่คาดหวังจากการดำเนินการฟังก์ชัน getSchema() และ/หรือ getData() ฟังก์ชันเหล่านี้จะแสดงผลการกำหนดค่าการค้นหาแทนที่จะดึงข้อมูลและ แสดงผลสคีมาและข้อมูล เมื่อมีการส่งคืนการกำหนดค่าการค้นหา Looker Studio จะดึงข้อมูลสคีมาและ/หรือข้อมูลโดยตรงตามการกำหนดค่าการค้นหาที่ระบุ

การพัฒนาเครื่องมือเชื่อมต่อ

เครื่องมือเชื่อมต่อชุมชนที่ใช้บริการขั้นสูงของ Looker Studio จะเหมือนกับ เครื่องมือเชื่อมต่อปกติ ยกเว้น 2 กรณี

  1. คีย์ไฟล์ Manifest เพิ่มเติม
  2. การตอบกลับที่แตกต่างจาก getSchema() และ/หรือ getData()

ข้อมูลอ้างอิงไฟล์ Manifest

ใน Manifest ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้เป็น true

  • สําหรับ getSchema() ให้ใช้พร็อพเพอร์ตี้ dataStudio.advancedServices.schema
  • สําหรับ getData() ให้ใช้พร็อพเพอร์ตี้ dataStudio.advancedServices.data

ค่า true แสดงว่าสำหรับฟังก์ชันที่เกี่ยวข้อง ตัวเชื่อมต่อ จะแสดงผลการกำหนดค่าการค้นหาแทนการตอบกลับมาตรฐาน

หากต้องการกำหนดสคีมาของคุณเองโดยใช้การตอบกลับมาตรฐาน getSchema() ให้ตั้งค่า dataStudio.advancedServices.schema เป็น false ในไฟล์ Manifest หรือละเว้นพร็อพเพอร์ตี้นี้ ซึ่งจำเป็นเมื่อฟิลด์ทั้งหมดในสคีมาไม่สามารถแสดงได้ด้วย การค้นหา BigQuery รายการเดียว เช่น เมื่อคุณสร้างเครื่องมือเชื่อมต่อแบบหลายสคีมา

เนื่องจากระบบจะเรียกใช้การค้นหา BigQuery ในนามของผู้ใช้ที่ได้รับอนุญาต คุณจึงต้องรวมขอบเขต OAuth ของ BigQuery ("https://www.googleapis.com/auth/bigquery.readonly") ไว้ในไฟล์ Manifest เพื่อขอการให้สิทธิ์ด้วย

ต่อไปนี้คือไฟล์ Manifest ของเครื่องมือเชื่อมต่อที่ใช้ข้อมูลเข้าสู่ระบบของผู้ใช้ที่ได้รับอนุญาตเพื่อ เชื่อมต่อกับ BigQuery

{
  "dataStudio": {
    "name": "BigQuery Public Dataset Demo",
    "logoUrl": "https://www.gstatic.com/images/branding/product/1x/data_connector_48dp.png",
    "company": "Looker DevRel",
    "companyUrl": "https://developers.google.com/looker-studio/",
    "addOnUrl": "https://developers.google.com/looker-studio/",
    "supportUrl": "https://developers.google.com/looker-studio/",
    "description": "Use BigQuery public dataset with Looker Studio's Advanced Services.",
    "advancedServices": {
      "schema": true,
      "data": true
    }
  },
  "oauthScopes": ["https://www.googleapis.com/auth/bigquery.readonly"]
}

หากคุณใช้บัญชีบริการเพื่อเข้าถึง BigQuery คุณก็ไม่จำเป็นต้องระบุขอบเขต OAuth ในไฟล์ Manifest bigquery.readonly อย่างไรก็ตาม ควรเพิ่ม ขอบเขตลงในรายการขอบเขตสำหรับบัญชีบริการ

การอ้างอิง getData และ getSchema

เครื่องมือเชื่อมต่อที่ใช้ Looker Studio Advanced Services จะแสดงออบเจ็กต์การกำหนดค่าการค้นหา สำหรับ getSchema() และ/หรือ getData() การกำหนดค่านี้อาจต้องมีพร็อพเพอร์ตี้เพิ่มเติม ทั้งนี้ขึ้นอยู่กับแหล่งข้อมูล

ต่อไปนี้คือตัวอย่างการใช้บริการ DataStudioApp เพื่อสร้างออบเจ็กต์การกำหนดค่านี้

var bqTypes = DataStudioApp.createCommunityConnector().BigQueryParameterType;
var configuration = DataStudioApp.createCommunityConnector().newBigQueryConfig()
    // BigQuery billing project's Id.
    .setBillingProjectId('billingProjectId')
    // The query that will be executed.
    .setQuery('myQueryString')
    // Set to `true` to use StandardSQL.
    .setUseStandardSql(true)
    // The accessToken used for service execution.
    .setAccessToken('myAccessToken')
    // Adding a `STRING` query parameter. Other supported types are `BOOL`,
    // `FLOAT64`, and `INT64`.
    .addQueryParameter('myUrlParameterName', bqTypes.STRING, 'myUrlParameterValue')
    .build();

ตัวอย่างฟังก์ชัน getSchema() และ getData()

var sqlString = "" +
    "SELECT " +
    "  _TABLE_SUFFIX AS yyyymm, " +
    "  ROUND(SUM(IF(fcp.start < @fast_fcp, fcp.density, 0)), 4) AS fast_fcp, " +
    "  ROUND(SUM(IF(fcp.start >= 1000 AND fcp.start < 3000, fcp.density, 0)), 4) AS avg_fcp, " +
    "  ROUND(SUM(IF(fcp.start >= 3000, fcp.density, 0)), 4) AS slow_fcp " +
    "FROM " +
    "  `chrome-ux-report.all.*`, " +
    "  UNNEST(first_contentful_paint.histogram.bin) AS fcp " +
    "WHERE " +
    "  origin = @url " +
    "GROUP BY " +
    "  yyyymm " +
    "ORDER BY " +
    "  yyyymm ";

function getQueryConfig(request) {
  var url = (request.configParams && request.configParams.url);
  var projectId = (request.configParams && request.configParams.projectId);
  var authToken = ScriptApp.getOAuthToken();
  return DataStudioApp.createCommunityConnector().newBigQueryConfig()
      .setAccessToken(authToken)
      .setUseStandardSql(true)
      .setBillingProjectId(projectId)
      .setQuery(sqlString)
      .addQueryParameter('url', bqTypes.STRING, url)
      .addQueryParameter('fast_fcp', bqTypes.INT64, '' + 1000)
      .build();
}

function getSchema(request) {
  return getQueryConfig(request);
}

function getData(request) {
  return getQueryConfig(request)
}