Operacje na tabelach

Interfejs API Prezentacji Google umożliwia tworzenie i edytowanie tabel na stronach. Przykłady w na tej stronie znajdziesz kilka typowych operacji na tabeli za pomocą presentations.batchUpdate .

W poniższych przykładach używane są te zmienne:

  • PRESENTATION_ID – wskazuje, gdzie podajesz atrybuty prezentacja Identyfikator. Dostępne opcje wartość tego identyfikatora można znaleźć w adresie URL prezentacji.
  • PAGE_ID – wskazuje miejsce, w którym podajesz obiekt strony. Identyfikatory. Możesz pobrać tę wartość z adresu URL lub za pomocą żądania odczytu interfejsu API.
  • TABLE_ID – wskazuje, gdzie udostępniasz stronę identyfikator obiektu elementu nad tabelą, nad którą pracujesz. Możesz podać ten identyfikator dla tworzonych elementów (z kilkoma ograniczenia) lub pozwolić interfejsowi API Prezentacji na ich automatyczne utworzenie. Identyfikatory elementów można pobierać za pomocą żądania odczytu interfejsu API.

Te przykłady są prezentowane jako żądania HTTP bez względu na język. Aby się uczyć Jak wdrożyć aktualizację zbiorczą w różnych językach przy użyciu interfejsu API Google? Więcej informacji znajdziesz w sekcji Dodawanie kształtów tekst.

Tworzenie tabeli

Poniżej presentations.batchUpdate przykładowy kod pokazuje, jak korzystać z CreateTableRequest aby dodać tabelę do slajdu określonego przez PAGE_ID.

Ta tabela ma osiem wierszy i pięć kolumn. Pamiętaj, że w interfejsie Prezentacji API ignoruje wszystkie pola size i transform podane w argumencie elementProperties. Zamiast tego interfejs API tworzy tabelę wyśrodkowaną mniej więcej na slajdzie dostosowane pod kątem określonej liczby wierszy i kolumn, jeśli to możliwe.

Aby utworzyć tabelę, użyj protokołu żądania:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createTable": {
        "objectId": TABLE_ID,
        "elementProperties": {
          "pageObjectId": PAGE_ID,
        },
        "rows": 8,
        "columns": 5
      }
    }
  ]
}

Usuwanie wierszy i kolumn tabeli

Poniżej presentations.batchUpdate przykładowy kod pokazuje, jak korzystać z DeleteTableRowRequest metody usuwania szóstego wiersza. Następnie korzysta z funkcji DeleteTableColumnRequest usuwania czwartej kolumny. Tabelę określa parametr TABLE_ID Zarówno rowIndex, jak i columnIndex w sekcji Liczby cellLocation są liczone od zera.

Protokół żądania usuwania wierszy i kolumn tabeli wygląda tak:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteTableRow": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 5
        }
      }
    },
    {
      "deleteTableColumn": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "columnIndex": 3
        }
      }
    }
  ]
}

Edytuj dane w tabeli

Poniżej presentations.batchUpdate przykładowy kod pokazuje, jak korzystać z DeleteTextRequest metody usuwania całego tekstu z komórki w textRange. it korzysta z funkcji InsertTextRequest , aby zastąpić go nowym tekstem „Kangaroo”.

Tabelę określa parametr TABLE_ID. Komórka, której dotyczy problem, znajduje się w: piąty wiersz i trzecia kolumna. Zarówno rowIndex, jak i columnIndex w obrębie Liczby cellLocation są liczone od zera.

Protokół żądania do edycji danych w tabeli:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteText": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 4,
          "columnIndex": 2
        },
        "textRange": {
          "type": "ALL",
        }
      }
    },
    {
      "insertText": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 4,
          "columnIndex": 2
        },
        "text": "Kangaroo",
        "insertionIndex": 0
      }
    }
  ]
}

Formatowanie wiersza nagłówka tabeli

Poniżej presentations.batchUpdate przykładowy kod pokazuje, jak korzystać z UpdateTableCellPropertiesRequest do formatowania wiersza nagłówka elementu tabeli w obrębie tableRange określone przez TABLE_ID. Następnie korzysta z funkcji TableCellProperties aby ustawić czarny kolor tła wiersza nagłówka.

Każde poniższe żądanie używa parametru UpdateTextStyleRequest metoda ustawiania formatu tekstu w jednej komórce wiersza nagłówka na pogrubienie, biały 18-punktowy Czcionka Cambria w textRange Ty musisz powtórzyć tę czynność dla każdej kolejnej komórki nagłówka.

Zarówno rowIndex, jak i columnIndex w: location oraz Wartości cellLocation są liczone od zera.

Oto protokół żądania do formatowania wiersza nagłówka tabeli:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updateTableCellProperties": {
        "objectId": TABLE_ID,
        "tableRange": {
          "location": {
            "rowIndex": 0,
            "columnIndex": 0
          },
          "rowSpan": 1,
          "columnSpan": 3
        },
        "tableCellProperties": {
          "tableCellBackgroundFill": {
            "solidFill": {
              "color": {
                "rgbColor": {
                  "red": 0.0,
                  "green": 0.0,
                  "blue": 0.0
                }
              }
            }
          }
        },
        "fields": "tableCellBackgroundFill.solidFill.color"
      }
    },
    {
      "updateTextStyle": {
        "objectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 0,
          "columnIndex": 0
        },
        "style": {
          "foregroundColor": {
            "opaqueColor": {
              "rgbColor": {
                "red": 1.0,
                "green": 1.0,
                "blue": 1.0
              }
            }
          },
          "bold": true,
          "fontFamily": "Cambria",
          "fontSize": {
            "magnitude": 18,
            "unit": "PT"
          }
        },
        "textRange": {
          "type": "ALL"
        },
        "fields": "foregroundColor,bold,fontFamily,fontSize"
      }
    },
    // Repeat the above request for each additional cell in the header row....
  ]
}

Tak wygląda sformatowany wiersz nagłówka po aktualizacji:

Sformatuj wynik przepisu wiersza nagłówka.

Wstawianie wierszy lub kolumn tabeli

Poniżej presentations.batchUpdate przykładowy kod pokazuje, jak korzystać z InsertTableRowsRequest dodawania 3 wierszy poniżej szóstego wiersza. Następnie korzysta z funkcji InsertTableColumnsRequest dodaj dwie kolumny po lewej stronie czwartej kolumny w tej samej tabeli.

Tabelę określa parametr TABLE_ID. Zarówno rowIndex, jak i Argument columnIndex w kolumnie cellLocation jest liczony od zera.

Protokół żądania wstawia wiersze lub kolumny tabeli:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "insertTableRows": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "rowIndex": 5
        },
        "insertBelow": true,
        "number": 3
      }
    },
    {
      "insertTableColumns": {
        "tableObjectId": TABLE_ID,
        "cellLocation": {
          "columnIndex": 3
        },
        "insertRight": false,
        "number": 2
      }
    }
  ]
}