Grundlegende Formatierung

Mit der Google Sheets API können Sie die Formatierung von Zellen und Bereichen aktualisieren in Tabellenkalkulationen. Anhand der Beispiele auf dieser Seite wird veranschaulicht, sind mit der Sheets API möglich. Sie können Weitere Beispiele für bedingte Formatierungen Rezeptseite.

Beim Aktualisieren einer Tabelle können bei einigen Arten von Anfragen Antworten zurückgegeben werden. Diese werden in einem Array zurückgegeben, wobei jede Antwort den gleichen Index wie der entsprechenden Anfrage. Für einige Anfragen gibt es keine Antworten. Antwort ist leer. Die Antwortstruktur für diese Beispiele finden Sie unter spreadsheets.batchUpdate

Diese Beispiele werden in Form von HTTP-Anfragen neutral sein. Um zu erfahren, wie Sie eine Batch-Aktualisierung in verschiedenen Sprachen mithilfe der Google API-Clientbibliotheken, siehe Aktualisieren Tabellen.

In diesen Beispielen haben die Platzhalter SPREADSHEET_ID und SHEET_ID gibt an, wo Sie diese IDs angeben würden. Sie finden die Tabelle ID in der Tabellen-URL. Sie erhalten Tabellenblatt-ID mithilfe des spreadsheets.get-Methode. Die Bereiche werden in der A1-Notation angegeben. Eine Beispielbereich ist Sheet1!A1:D5.

Im obigen Video erfahren Sie, wie Sie Zellen in Tabellenkalkulationen auf verschiedene wie z. B.: Fixierte Zeilen erstellen, Zellen fett formatieren, Währungscode implementieren Formatieren, Validieren und Einschränken von Zellenwerten.

Zellenrahmen bearbeiten

Die folgenden spreadsheets.batchUpdate wird gezeigt, wie Sie mit der UpdateBordersRequest um jeder Zelle im Bereich A1:F10 einen gestrichelten blauen Rahmen zu geben. Die Mit dem Feld innerHorizontal wird der Bereich innerhalb des Bereichs horizontal mit Rahmenlinien versehen. Wird das Feld ausgelassen, werden die Rahmen nur oben und des gesamten Bereichs.

Tabelle mit 3 zu 3, wobei jede Zelle oben und unten einen gestrichelten blauen Rahmen hat.
Abbildung 1: Formatieren Sie jede Zelle in einem Tabellenblatt mit einem gestrichelten blauen Rahmen oben und unten.

Das Anfrageprotokoll ist unten zu sehen.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "updateBorders": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 6
        },
        "top": {
          "style": "DASHED",
          "width": 1,
          "color": {
            "blue": 1.0
          },
        },
        "bottom": {
          "style": "DASHED",
          "width": 1,
          "color": {
            "blue": 1.0
          },
        },
        "innerHorizontal": {
          "style": "DASHED",
          "width": 1,
          "color": {
            "blue": 1.0
          },
        },
      }
    }
  ]
}

Kopfzeile formatieren

Die folgenden spreadsheets.batchUpdate wird gezeigt, wie Sie mit der RepeatCellRequest um eine Kopfzeile in einem Tabellenblatt zu formatieren. Die erste Anforderung aktualisiert die Textfarbe, den die Hintergrundfarbe, die Schriftgröße und die Ausrichtung. Text fett. Das Weglassen der Spaltenindexe im Feld range führt dazu, dass die gesamte Zeile, die formatiert werden soll. Mit der zweiten Anfrage werden die Blatteigenschaften so angepasst, Kopfzeile ist fixiert.

3 mal 3-Tabelle mit einer formatierten Kopfzeile in einem Tabellenblatt.
Abbildung 2: Formatieren Sie die Kopfzeile in einem Tabellenblatt.

Das Anfrageprotokoll ist unten zu sehen.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 1
        },
        "cell": {
          "userEnteredFormat": {
            "backgroundColor": {
              "red": 0.0,
              "green": 0.0,
              "blue": 0.0
            },
            "horizontalAlignment" : "CENTER",
            "textFormat": {
              "foregroundColor": {
                "red": 1.0,
                "green": 1.0,
                "blue": 1.0
              },
              "fontSize": 12,
              "bold": true
            }
          }
        },
        "fields": "userEnteredFormat(backgroundColor,textFormat,horizontalAlignment)"
      }
    },
    {
      "updateSheetProperties": {
        "properties": {
          "sheetId": SHEET_ID,
          "gridProperties": {
            "frozenRowCount": 1
          }
        },
        "fields": "gridProperties.frozenRowCount"
      }
    }
  ]
}

Zellen verbinden

Die folgenden spreadsheets.batchUpdate wird gezeigt, wie Sie mit der MergeCellsRequest um Zellen zu verbinden. In der ersten Anforderung wird der A1:B2-Bereich zu einer einzigen Zelle zusammengeführt. Die bei der zweiten Anfrage werden die Spalten in A3:B6 zusammengeführt, wobei die Zeilen getrennt bleiben.

3 × 3-Tabelle mit verbundenen Zellen in einem Tabellenblatt.
Abbildung 3: Zellen in einem Tabellenblatt verbinden

Das Anfrageprotokoll ist unten zu sehen.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "mergeCells": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 2,
          "startColumnIndex": 0,
          "endColumnIndex": 2
        },
        "mergeType": "MERGE_ALL"
      }
    },
    {
      "mergeCells": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 2,
          "endRowIndex": 6,
          "startColumnIndex": 0,
          "endColumnIndex": 2
        },
        "mergeType": "MERGE_COLUMNS"
      }
    },
  ]
}

Benutzerdefiniertes Datums- oder Dezimalformat für einen Bereich festlegen

Die folgenden spreadsheets.batchUpdate wird gezeigt, wie Sie mit der RepeatCellRequest , um Zellen mit benutzerdefinierten Datums- und Zahlenformaten zu aktualisieren. Die erste Anfrage gibt den Zellen im Bereich A1:A10 das benutzerdefinierte Datum/Uhrzeit-Format hh:mm:ss am/pm, ddd mmm dd yyyy an. Ein Beispiel für Datum/Uhrzeit in diesem Format ist: "02:05:07 PM, Sun Apr. 03 2016".

In der zweiten Anfrage erhalten die Zellen in B1:B10 das benutzerdefinierte Zahlenformat. #,##0.0000, was angibt, dass Zahlen mit einem Komma gruppiert werden sollen Trennzeichen eingeben, dass nach dem Dezimaltrennzeichen 4 Ziffern stehen und dass nur dass eine führende Null entfernt werden sollte. Zum Beispiel die Zahl „3, 14“ wird gerendert als „3.1400“ und „12345.12345“ wird als „12,345.1235“ gerendert.

3 × 3-Tabelle mit benutzerdefinierten Datums- und Zahlenformaten in einem Tabellenblatt.
Abbildung 4: Aktualisieren Sie die Zellen, sodass sie benutzerdefinierte Datums- und Zahlenformate in einem Tabellenblatt haben.

Das Anfrageprotokoll ist unten zu sehen.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 1
        },
        "cell": {
          "userEnteredFormat": {
            "numberFormat": {
              "type": "DATE",
              "pattern": "hh:mm:ss am/pm, ddd mmm dd yyyy"
            }
          }
        },
        "fields": "userEnteredFormat.numberFormat"
      }
    },
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 1,
          "endColumnIndex": 2
        },
        "cell": {
          "userEnteredFormat": {
            "numberFormat": {
              "type": "NUMBER",
              "pattern": "#,##0.0000"
            }
          }
        },
        "fields": "userEnteredFormat.numberFormat"
      }
    }
  ]
}