Прямая ссылка

Вы можете предоставить общий доступ к любому развертыванию коннектора независимых разработчиков по ссылке. По ней пользователи смогут переходить непосредственно на страницу Центра данных с выбранным и готовым к настройке коннектором.

Чтобы получить такую ссылку, выполните следующие действия:

  1. Перейдите к Apps Script и откройте проект коннектора, к которому нужно предоставить доступ. Нажмите Публикация > Развернуть из манифеста.
  2. Нажмите на название нужного развертывания или на значок Студии данных рядом со ссылкой Get ID (Получить идентификатор). Появится прямая ссылка на этот коннектор в Студии данных. Вы можете воспользоваться и другим способом: нажмите на ссылку Get ID, скопируйте идентификатор развертывания и добавьте его в следующий URL:
    https://datastudio.google.com/datasources/create?connectorId=YOUR_DEPLOYMENT_ID
  3. Прямую ссылку можно опубликовать на сайте, в блоге или в социальной сети.

Подстановка параметров конфигурации по ссылке

Если вам заранее известно, какие параметры конфигурации коннектора будут нужны пользователям, вы можете указать их в ссылке, чтобы значения подставлялись автоматически. Пользователям не придется вводить их вручную, хотя при необходимости они смогут их изменить.

Чтобы указать параметры конфигурации прямо в ссылке на коннектор, добавьте в нее следующие параметры (все они являются необязательными):

  • connectorConfig – URL-кодированная строка JSON, содержащая пары "ключ-значение", которые будут подставляться в соответствующие поля.

    • Названия ключей должны соответствовать названиям параметров, определенных в конфигурации коннектора.
    • Значения TEXTINPUT, TEXTAREA и SELECT_SINGLE должны быть строковыми.
    • Значения CHECKBOX должны быть логическими.
    • Значения SELECT_MULTIPLE должны быть массивами строк.
  • reportTemplateId – идентификатор шаблона отчета по умолчанию, который будет использоваться с коннектором. Если в манифесте коннектора задан шаблон по умолчанию, он будет переопределен. О том, как добавить шаблон отчета в манифест, читайте здесь.

Пример

В примере ниже показано, как создать прямую ссылку на коннектор для вопросов на форуме StackOverflow. В конфигурацию коннектора будет подставлен параметр, позволяющий использовать на StackOverflow тег google-data-studio.

Прямая ссылка на коннектор StackOverflow

1. Создайте JSON-конфигурацию

Ключами в JSON-данных с конфигурацией служат названия ее элементов. Для StackOverflow это tagged, pagesize и sort.

Конфигурация до URL-кодирования

{
        "tagged": "google-data-studio",
        "pagesize": 25,
        "sort": "activity"
    }
    

2. Преобразуйте данные в URL-кодированную форму

Закодируйте JSON-объект для передачи в URL. Это проще всего сделать с помощью функции JavaScript encodeURIComponent.

URL-кодирование

// get a reference to the jsonConfig
    var jsonConfig;
    var encoded = encodeURIComponent(jsonConfig);
    

В результате получается следующая строка:

"%7B%22tagged%22%3A%22google-data-studio%22%2C%22pagesize%22%3A%2225%22%2C%22sort%22%3A%22activity%22%7D"
    

3. Сформируйте URL

Приведенный ниже код формирует прямую ссылку. Обратите внимание, что для создания URL вам понадобится идентификатор развертывания коннектора.

data-studio/links.gs
// These variables should be filled in as necessary for your connector.
    var configJSON;
    var templateId;
    var deploymentId;

    var params = [];

    const jsonString = JSON.stringify(configJSON);
    let encoded = encodeURIComponent(jsonString);
    params.push('connectorConfig=' + encoded);

    params.push('reportTemplateId=' + templateId);

    params.push('connectorId=' + deploymentId);

    const joinedParams = params.join('&');
    const URL = 'https://datastudio.google.com/datasources/create?' + joinedParams;

Этот фрагмент кода возвращает следующую прямую ссылку с закодированным в нее коннектором:

https://datastudio.google.com/datasources/create?connectorConfig=%7B%22tagged%22%3A%22google-data-studio%22%2C%22pagesize%22%3A%2225%22%2C%22sort%22%3A%22activity%22%7D&reportTemplateId=1lR9CGfx3uyQp6oz7oAgA1rsqZViA-IQs&connectorId=AKfycbwGMj-oe532y-NEbMHo-KLUCEz0EEGOZj-3lhEgw7q65-hs-T_F9B3Qjw
    

Посмотрите, как ссылка заполняет значения конфигурации (требуется доступ).