Как работать с JSON-файлами в Google Apps Script?

/**
 * Получает JSON данные из указанного URL.
 * @param {string} url URL для получения JSON.
 * @return {object} Объект JavaScript, полученный из JSON, или null в случае ошибки.
 */
function getJsonFromUrl(url: string): object | null {
  try {
    const response = UrlFetchApp.fetch(url);
    const jsonString = response.getContentText();
    const jsonData = JSON.parse(jsonString);
    return jsonData;
  } catch (e) {
    Logger.log('Ошибка при получении JSON: ' + e);
    return null;
  }
}

// Пример использования
const apiUrl = 'https://jsonplaceholder.typicode.com/todos/1';
const data = getJsonFromUrl(apiUrl);
if (data) {
  Logger.log(data.title);
}

/**
 * Читает JSON из указанной ячейки Google Sheets.
 * @param {string} spreadsheetId ID Google Sheets.
 * @param {string} sheetName Название листа.
 * @param {string} cell Адрес ячейки (например, 'A1').
 * @return {object} Объект JavaScript, полученный из JSON, или null в случае ошибки.
 */
function getJsonFromSheet(spreadsheetId: string, sheetName: string, cell: string): object | null {
  try {
    const spreadsheet = SpreadsheetApp.openById(spreadsheetId);
    const sheet = spreadsheet.getSheetByName(sheetName);
    if (!sheet) {
      Logger.log('Лист с именем ' + sheetName + ' не найден.');
      return null;
    }
    const jsonString = sheet.getRange(cell).getValue();
    const jsonData = JSON.parse(jsonString);
    return jsonData;
  } catch (e) {
    Logger.log('Ошибка при чтении JSON из Sheets: ' + e);
    return null;
  }
}

// Пример использования
const spreadsheetId = 'YOUR_SPREADSHEET_ID';
const sheetName = 'Sheet1';
const cell = 'A1';
const data = getJsonFromSheet(spreadsheetId, sheetName, cell);
if (data) {
  Logger.log(data);
}

/**
 * Читает JSON из файла на Google Drive.
 * @param {string} fileId ID файла на Google Drive.
 * @return {object} Объект JavaScript, полученный из JSON, или null в случае ошибки.
 */
function getJsonFromFile(fileId: string): object | null {
  try {
    const file = DriveApp.getFileById(fileId);
    const jsonString = file.getBlob().getDataAsString();
    const jsonData = JSON.parse(jsonString);
    return jsonData;
  } catch (e) {
    Logger.log('Ошибка при чтении JSON из Drive: ' + e);
    return null;
  }
}

// Пример использования
const fileId = 'YOUR_FILE_ID';
const data = getJsonFromFile(fileId);
if (data) {
  Logger.log(data);
}

const jsonString = '{"name":"John", "age":30, "city":"New York"}';
const obj = JSON.parse(jsonString);
Logger.log(obj.name); // Выведет: John

const obj = { name: 'John', age: 30, city: 'New York' };
const jsonString = JSON.stringify(obj);
Logger.log(jsonString); // Выведет: {"name":"John","age":30,"city":"New York"}

const jsonString = '{"name":"John", "address":{"street":"Main St", "city":"New York"}, "hobbies":["reading", "coding"]}';
const obj = JSON.parse(jsonString);
Logger.log(obj.address.city); // Выведет: New York
Logger.log(obj.hobbies[0]); // Выведет: reading

/**
 * Создает JSON файл на Google Drive.
 * @param {object} data Данные для записи в JSON файл.
 * @param {string} fileName Имя файла.
 * @param {string} folderId ID папки на Google Drive (необязательно).
 * @return {string} ID созданного файла.
 */
function createJsonFile(data: object, fileName: string, folderId?: string): string {
  const jsonString = JSON.stringify(data);
  const blob = Utilities.newBlob(jsonString, 'application/json', fileName + '.json');
  let folder;
  if (folderId) {
    folder = DriveApp.getFolderById(folderId);
  } else {
    folder = DriveApp.getRootFolder();
  }
  const file = folder.createFile(blob);
  return file.getId();
}

// Пример использования
const data = { name: 'John', age: 30 };
const fileName = 'data';
const fileId = createJsonFile(data, fileName);
Logger.log('Файл создан с ID: ' + fileId);

/**
 * Записывает JSON данные в указанную ячейку Google Sheets.
 * @param {string} spreadsheetId ID Google Sheets.
 * @param {string} sheetName Название листа.
 * @param {string} cell Адрес ячейки (например, 'A1').
 * @param {object} data Данные для записи в JSON.
 */
function writeJsonToSheet(spreadsheetId: string, sheetName: string, cell: string, data: object): void {
  const spreadsheet = SpreadsheetApp.openById(spreadsheetId);
  const sheet = spreadsheet.getSheetByName(sheetName);
  if (!sheet) {
    Logger.log('Лист с именем ' + sheetName + ' не найден.');
    return;
  }
  const jsonString = JSON.stringify(data);
  sheet.getRange(cell).setValue(jsonString);
}

// Пример использования
const spreadsheetId = 'YOUR_SPREADSHEET_ID';
const sheetName = 'Sheet1';
const cell = 'A1';
const data = { name: 'John', age: 30 };
writeJsonToSheet(spreadsheetId, sheetName, cell, data);

const obj = { name: 'John', age: 30, city: 'New York' };
const jsonString = JSON.stringify(obj, null, 2); // 2 - количество пробелов для отступов
Logger.log(jsonString);
/* Выведет:
{
  "name": "John",
  "age": 30,
  "city": "New York"
}
*/

/**
 * Получает курсы валют из API и записывает их в Google Sheets.
 * @param {string} spreadsheetId ID Google Sheets.
 * @param {string} sheetName Название листа.
 */
function updateCurrencyRates(spreadsheetId: string, sheetName: string): void {
  const apiUrl = 'https://api.exchangerate-api.com/v4/latest/USD'; // Пример API
  const data = getJsonFromUrl(apiUrl);

  if (!data || !data.rates) {
    Logger.log('Не удалось получить данные о курсах валют.');
    return;
  }

  const rates = data.rates;
  const spreadsheet = SpreadsheetApp.openById(spreadsheetId);
  const sheet = spreadsheet.getSheetByName(sheetName);
  if (!sheet) {
    Logger.log('Лист с именем ' + sheetName + ' не найден.');
    return;
  }

  // Записываем заголовки столбцов
  sheet.getRange('A1').setValue('Currency');
  sheet.getRange('B1').setValue('Rate');

  let row = 2;
  for (const currency in rates) {
    sheet.getRange(row, 1).setValue(currency);
    sheet.getRange(row, 2).setValue(rates[currency]);
    row++;
  }
}

// Пример использования
const spreadsheetId = 'YOUR_SPREADSHEET_ID';
const sheetName = 'CurrencyRates';
updateCurrencyRates(spreadsheetId, sheetName);