feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 5
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/grid%2Fspreadsheet-api-81154a75608f9e6eee6e73e9565f7c062e2277a812021713cf1fe70b0516189c.yml
-openapi_spec_hash: a84243958fdcbc1d229f8c8b73815908
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/grid%2Fspreadsheet-api-abb33a630edc4ccab958d6ecf6d97989abb5d7324f240daf79105dc6dd5bc64a.yml
+openapi_spec_hash: cfb42c5a725db1d29520b453d48f2115
 config_hash: 3e61a9566953ce5dbd4bcea7ceb568a3

src/resources/workbooks.ts

@@ -80,7 +80,7 @@ export class Workbooks extends APIResource {
    * @example
    * ```ts
    * const response = await client.workbooks.renderChart('id', {
-   *   chart: { data: '=C2:C142' },
+   *   chart: {},
    * });
    *
    * const content = await response.blob();
@@ -895,35 +895,190 @@ export namespace WorkbookRenderChartParams {
    * type, image output format, and title and axis labels.
    */
   export interface Chart {
+    /**
+     * How an axis representing dimensional categories is presented.
+     */
+    axisDim?: Chart.AxisDim | null;
+
+    /**
+     * How an axis representing value magnitudes is presented.
+     */
+    axisValue?: Chart.AxisValue | null;
+
+    /**
+     * Enum representing the supported strategies for handling blank or missing data
+     * points.
+     */
+    blanks?: 'gap' | 'zero' | 'span' | null;
+
+    /**
+     * An Excel array expression that returns a 1-dimensional list of HTML color
+     * strings
+     */
+    chartColors?: string | null;
+
+    /**
+     * Vary colors by point rather than series.
+     */
+    colorByPoint?: string | null;
+
     /**
      * Chart data range, prefixed with an equals sign
      */
-    data: string | null;
+    data?: string | null;
+
+    /**
+     * Chart data range, prefixed with an equals sign, used for lines in a combo chart
+     */
+    dataLines?: string | null;
+
+    /**
+     * Enum representing the supported read orientations for data directions.
+     */
+    dir?: '' | 'col' | 'row' | null;
+
+    /**
+     * Cell reference to use as the chart's footnote text. Can also be plain text.
+     */
+    footnote?: string | null;
+
+    /**
+     * Supported image types for rendering charts from workbook data.
+     */
+    format?: 'png' | 'svg' | null;
 
     /**
-     * File format to use for the chart image
+     * Enum representing the supported interpolation types for data visualization or
+     * curve fitting.
      */
-    format?: 'png' | 'svg';
+    interpolate?: 'linear' | 'step' | 'step-after' | 'step-before' | 'monotone' | 'basis' | null;
 
     /**
      * Range of cells to use as the chart's x-axis labels, prefixed with an equals sign
      */
     labels?: string | null;
 
+    /**
+     * Range of cells to use as the chart's legend labels, prefixed with an equals sign
+     */
+    legend?: string | null;
+
+    /**
+     * Range of cells to use as the chart's line labels in the legend, prefixed with an
+     * equals sign
+     */
+    legendLines?: string | null;
+
+    /**
+     * Whether to display a chart legend
+     */
+    legendVisible?: 'false' | 'true' | null;
+
+    /**
+     * Number format pattern used for formatting labels on the chart.
+     */
+    numberFormat?: string | null;
+
+    /**
+     * The number of which series the data should be sorted by (e.g. 1 for the first
+     * series).
+     */
+    sortBy?: number | null;
+
+    /**
+     * The sorting direction when the sortBy property is set.
+     */
+    sortOrder?: '' | 'ascending' | 'descending' | null;
+
+    /**
+     * Whether to display series stacked or grouped
+     */
+    stacked?: 'false' | 'true' | null;
+
+    /**
+     * Cell reference to use as the chart's subtitle. Can also be plain text.
+     */
+    subtitle?: string | null;
+
     /**
      * Cell reference to use as the chart's title. Can also be plain text.
      */
     title?: string | null;
 
     /**
-     * Type of chart to render
+     * Types of charts that can be rendered using workbook data.
+     */
+    type?: 'area' | 'bar' | 'column' | 'combo' | 'line' | 'pie' | 'scatterplot' | 'waterfall' | null;
+
+    /**
+     * Options for labelling individual data values on a chart. If "none" (the default)
+     * then no data labels are shown. If "selective", data labels are shown when they
+     * fit without overlap. If "all", all values are labelled.
+     */
+    values?: 'none' | 'selective' | 'all' | null;
+  }
+
+  export namespace Chart {
+    /**
+     * How an axis representing dimensional categories is presented.
      */
-    type?: 'line' | 'column';
+    export interface AxisDim {
+      /**
+       * Number format pattern used for formatting the axis labels.
+       */
+      numberFormat?: string | null;
+
+      /**
+       * If true, invert the scale of the axis. If false, keep the order untouched.
+       */
+      reverse?: 'false' | 'true' | null;
+
+      /**
+       * Cell reference to use as the axis title. Can also be plain text.
+       */
+      title?: string | null;
+    }
 
     /**
-     * How to label individual data values on the chart
+     * How an axis representing value magnitudes is presented.
      */
-    values?: 'none' | 'selective' | 'all';
+    export interface AxisValue {
+      /**
+       * If true, any graphics outside the min or max boundaries of the axes are
+       * truncated.
+       */
+      clip?: 'false' | 'true' | null;
+
+      /**
+       * A maximum value for the axis.
+       */
+      max?: number | null;
+
+      /**
+       * A minimum value for the axis.
+       */
+      min?: number | null;
+
+      /**
+       * Number format pattern used for formatting the axis labels.
+       */
+      numberFormat?: string | null;
+
+      /**
+       * Draw the axis in ascending or descending order.
+       */
+      reverse?: 'false' | 'true' | null;
+
+      /**
+       * Cell reference to use as the axis title. Can also be plain text.
+       */
+      title?: string | null;
+
+      /**
+       * Types of scales that can be used by an axis.
+       */
+      type?: 'linear' | 'log' | null;
+    }
   }
 
   /**

tests/api-resources/workbooks.test.ts

@@ -54,11 +54,36 @@ describe('resource workbooks', () => {
   test.skip('renderChart: required and optional params', async () => {
     const response = await client.workbooks.renderChart('id', {
       chart: {
+        axisDim: { numberFormat: '#,##0.0', reverse: 'false', title: '=C4' },
+        axisValue: {
+          clip: 'false',
+          max: 0,
+          min: 0,
+          numberFormat: '#,##0.0',
+          reverse: 'false',
+          title: '=C4',
+          type: 'linear',
+        },
+        blanks: 'gap',
+        chartColors: '={"#C40";"#03F"}',
+        colorByPoint: 'colorByPoint',
         data: '=C2:C142',
+        dataLines: '=C2:C142',
+        dir: 'row',
+        footnote: '=H13',
         format: 'png',
+        interpolate: 'linear',
         labels: '=B2:B142',
+        legend: '=D2:D142',
+        legendLines: '=E2:E142',
+        legendVisible: 'false',
+        numberFormat: '#,##0.0',
+        sortBy: 0,
+        sortOrder: '',
+        stacked: 'false',
+        subtitle: '=B4',
         title: '=A1',
-        type: 'line',
+        type: 'area',
         values: 'none',
       },
       apply: [{ target: 'A2', value: 1234 }],