Une feuille Google Sheets qui se remplit avec les séances d’un cinéma

Date        Heure  Film                        Durée    Version  Format  Réservation
2026-11-06  11:50  Sourires d'une nuit d'été   1 h 49   VOST     2D      https://www.cinema-lechampo.com/…
2026-11-06  11:55  Le Septième Sceau           1 h 36   VOST     2D      https://www.cinema-lechampo.com/…
2026-11-06  13:45  Affreux, sales et méchants  1 h 55   VOST     2D      https://www.cinema-lechampo.com/…

curl "https://api.api-cinema.com/v1/cinemas?q=champo" -H "Authorization: Bearer ac_live_…"

// Une feuille Google Sheets qui se remplit avec les séances d’un cinéma, depuis API Cinéma.
// Menu « Cinéma » : enregistrer la clé une fois, mettre à jour maintenant, ou chaque matin.

const API = 'https://api.api-cinema.com/v1'
const HEADER = ['Date', 'Heure', 'Film', 'Durée', 'Version', 'Format', 'Réservation']

function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu('Cinéma')
    .addItem('Mettre à jour les séances', 'updateShowtimes')
    .addItem('Mettre à jour chaque matin', 'installDailyTrigger')
    .addSeparator()
    .addItem('Enregistrer la clé API…', 'setApiKey')
    .addToUi()
}

/** La clé vit dans les propriétés du script : jamais dans une cellule, jamais dans le code. */
function setApiKey() {
  const ui = SpreadsheetApp.getUi()
  const answer = ui.prompt('Clé API Cinéma', 'Collez votre clé (ac_live_…).', ui.ButtonSet.OK_CANCEL)
  if (answer.getSelectedButton() !== ui.Button.OK)
    return
  PropertiesService.getScriptProperties().setProperty('API_CINEMA_KEY', answer.getResponseText().trim())
}

function updateShowtimes() {
  const key = PropertiesService.getScriptProperties().getProperty('API_CINEMA_KEY')
  if (!key)
    throw new Error('Pas encore de clé API : Cinéma › Enregistrer la clé API…')

  const ss = SpreadsheetApp.getActiveSpreadsheet()
  const config = configSheet(ss)
  const slug = String(config.getRange('B1').getValue()).trim()
  const days = Math.max(1, Math.min(14, Number(config.getRange('B2').getValue()) || 7))
  if (!slug)
    throw new Error('Mettez le slug du cinéma dans Config!B1')

  const rows = fetchShowtimes(key, slug, days).map(s => [
    s.startsAt.slice(0, 10), // date et heure locales du cinéma, telles que l’API les donne
    s.startsAt.slice(11, 16),
    s.movie.title,
    s.movie.durationMin ? `${Math.floor(s.movie.durationMin / 60)} h ${String(s.movie.durationMin % 60).padStart(2, '0')}` : '',
    s.version,
    s.format,
    s.bookingUrl || '',
  ])

  const sheet = ss.getSheetByName('Séances') || ss.insertSheet('Séances')
  sheet.clearContents()
  sheet.getRange(1, 1, 1, HEADER.length).setValues([HEADER]).setFontWeight('bold')
  if (rows.length)
    sheet.getRange(2, 1, rows.length, HEADER.length).setValues(rows)
  sheet.setFrozenRows(1)
  sheet.autoResizeColumns(1, HEADER.length)
  config.getRange('B3').setValue(new Date())
}

/** Toutes les séances du cinéma de maintenant à `days` jours, page par page. */
function fetchShowtimes(key, slug, days) {
  const to = new Date()
  to.setDate(to.getDate() + days - 1) // `to` est un jour entier : 7 jours = aujourd’hui et les 6 suivants
  const params = { to: Utilities.formatDate(to, Session.getScriptTimeZone(), 'yyyy-MM-dd'), include: 'movie', limit: 1000 }
  const all = []
  let cursor
  do {
    const query = Object.entries({ ...params, cursor })
      .filter(([, v]) => v !== undefined)
      .map(([k, v]) => `${k}=${encodeURIComponent(v)}`)
      .join('&')
    const res = UrlFetchApp.fetch(`${API}/cinemas/${encodeURIComponent(slug)}/showtimes?${query}`, {
      headers: { Authorization: `Bearer ${key}` },
      muteHttpExceptions: true,
    })
    if (res.getResponseCode() !== 200) {
      throw new Error(`API Cinéma a répondu ${res.getResponseCode()} : ${res.getContentText().slice(0, 200)}`)
    }
    const body = JSON.parse(res.getContentText())
    all.push(...body.data)
    cursor = body.meta && body.meta.nextCursor
  } while (cursor)
  return all
}

/** La feuille Config, créée avec des valeurs par défaut la première fois. */
function configSheet(ss) {
  let sheet = ss.getSheetByName('Config')
  if (!sheet) {
    sheet = ss.insertSheet('Config')
    sheet.getRange('A1:B3').setValues([
      ['Slug du cinéma', 'le-champo-paris-5e-arrondissement'],
      ['Jours', 7],
      ['Dernière mise à jour', ''],
    ])
    sheet.autoResizeColumns(1, 2)
  }
  return sheet
}

/** Une mise à jour par jour, vers 6 h du matin, dans le fuseau de la feuille. */
function installDailyTrigger() {
  ScriptApp.getProjectTriggers()
    .filter(t => t.getHandlerFunction() === 'updateShowtimes')
    .forEach(t => ScriptApp.deleteTrigger(t))
  ScriptApp.newTrigger('updateShowtimes').timeBased().everyDays(1).atHour(6).create()
  SpreadsheetApp.getUi().alert('La feuille Séances se mettra à jour chaque matin.')
}