Function fetchVideosByIds

apps/sim/connectors/youtube/youtube.ts:226–260

* Batch-fetches full video resources for the given IDs via `videos.list`. * * `videos.list` accepts up to 50 comma-separated IDs and costs a flat 1 quota unit per * call regardless of ID count, so a single call covers a full `playlistItems.list` page. * Videos that are private, deleted, or regio

(
  apiKey: string,
  videoIds: string[],
  retryOptions?: Parameters<typeof fetchWithRetry>[2]
)

 * Videos that are private, deleted, or region-blocked are simply absent from the response.
 */
async function fetchVideosByIds(
  apiKey: string,
  videoIds: string[],
  retryOptions?: Parameters<typeof fetchWithRetry>[2]
): Promise<Map<string, VideoItem>> {
  const result = new Map<string, VideoItem>()
  if (videoIds.length === 0) return result

  const url = `${YOUTUBE_API_BASE}/videos?part=snippet,contentDetails,status&id=${encodeURIComponent(
    videoIds.join(',')
  )}&key=${encodeURIComponent(apiKey)}`

  const response = await fetchWithRetry(
    url,
    { method: 'GET', headers: { Accept: 'application/json' } },
    retryOptions
  )

  if (!response.ok) {
    const errorText = await response.text().catch(() => '')
    logger.error('Failed to batch-fetch YouTube videos', {
      count: videoIds.length,
      status: response.status,
      error: errorText.slice(0, 500),
    })
    throw new Error(`Failed to batch-fetch YouTube videos: ${response.status}`)
  }

  const data = await response.json()
  const items = (data.items ?? []) as VideoItem[]
  for (const item of items) {
    if (item.id) result.set(item.id, item)
  }
  return result
}

/**
 * Builds the full document for a video, combining title and description as plain-text