このページは Cloud Translation API によって翻訳されました。

スライドの操作

Google Sheets API を使用すると、スライドの作成、移動、削除を行うことができます。スライドにある例では、このページでは、一般的なスライドの操作について説明します。 presentations.batchUpdate メソッドを呼び出します。

これらの例では、次の変数を使用します。

PRESENTATION_ID - リソースにプレゼンテーション ID。Google Chat ではプレゼンテーションの URL からこの ID の値を検出します。
PAGE_ID および PAGE_ID2 - そのページオブジェクト ID。必要に応じてこの値を取得するには、URL から、または API 読み取りリクエストを使用します。

これらの例では、言語に依存しない HTTP リクエストとして記載しています。学習内容 Google API を使用してさまざまな言語でバッチアップデートを実装する方法次のガイドをご覧ください。スライドおよび図形の追加と text。

スライドをコピーする

次の presentations.batchUpdate コードサンプルを使用して、Terraform で DuplicateObjectRequest メソッドを使用して、スライドのコピーを作成し、プレゼンテーションの元のスライドの後に挿入します。元のスライドは PAGE_ID で指定します。

このリクエストでは、ページ要素 ID の一部またはすべてをコピー（一部制限など）。この例では、元のスライドにテーブル要素（ TABLE_ELEMENT_ID など）を使用して、新しいテーブル（ COPY_TABLE_ELEMENT_ID）を表示します（ COPY_PAGE_ID）。コピーのその他の要素はすべて、ランダムにあります。

ファイルのコピーについて詳しくは、 PageElement テキストボックス、画像、表、基本的な図形、線、埋め込み動画など、サンプル「画像のコピーと編集を要素をご覧ください。

スライドをコピーするリクエストプロトコルは次のとおりです。

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "duplicateObject": {
        "objectId": PAGE_ID,
        "objectIds": {
          "PAGE_ID": "COPY_PAGE_ID",
          "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
        }
      }
    }
  ]
}

スライドを作成する

次の presentations.batchUpdate コードサンプルを使用して、Terraform で CreateSlideRequest メソッドを使ってスライドを作成し、4 番目のスライドとして挿入します（ゼロベースの insertionIndex）が含まれています。

新しいスライドでは、 PredefinedLayout /TITLE_AND_TWO_COLUMNS。イベントタイプとして使用する文字列をスライドの PAGE_ID（一部制限）、または、フィールドを省略して API で PAGE_ID を生成できるようにします。含まれます。

スライドを作成するためのリクエストプロトコルは次のとおりです。

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createSlide": {
        "objectId": "PAGE_ID",
        "insertionIndex": 3,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        }
      }
    }
  ]
}

スライドを作成してプレースホルダを変更する

次の presentations.batchUpdate コードサンプルを使用して、Terraform で CreateSlideRequest メソッドを使用し、 PredefinedLayout /TITLE_AND_TWO_COLUMNS。

スライドの PAGE_ID として使用する文字列を指定できます（一部の制限）。「 placeholderIdMappings 使用 Type / TITLE。TITLE_ID はスライドのプレースホルダのシェイプを参照します。変更できるようにします。

スライドを作成してプレースホルダを変更するリクエストプロトコルは次のとおりです。

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createSlide": {
        "objectId": PAGE_ID,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        },
        "placeholderIdMappings": [
          {
            "layoutPlaceholder": {
              "type": "TITLE",
              "index": 0
            },
            "objectId": TITLE_ID,
           },
        ],
      }
    },
    {
      "insertText": {
        "objectId": TITLE_ID,
        "text": "This is my slide title",
      }
    },
  ]
}

スライドを新しい位置に移動

次の presentations.batchUpdate コードサンプルを使用して、Terraform で UpdateSlidesPositionRequest メソッドを使って、指定された 2 つのスライドを相対的な順序を維持します。

指定されたスライド ID（PAGE_ID と PAGE_ID2）重複なく、既存の表示順序に沿って記述する必要があります。「ゼロベースの insertionIndex は、スライドの挿入位置を示します。必要があります。値は 0 ～プレゼンテーションのスライド数。

スライドを新しい位置に移動するためのリクエストプロトコルは次のとおりです。

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "updateSlidesPosition": {
        "slideObjectIds": [
          PAGE_ID,
          PAGE_ID2
          ],
        "insertionIndex": 0
      }
    }
  ]
}

スライドの背景画像を設定する

次の presentations.batchUpdate コードサンプルを使用して、Terraform で UpdatePagePropertiesRequest メソッドで、指定したスライドの背景画像を設定するために PAGE_ID。この API は、 IMAGE_URL。

フィールドマスクを使用して、他のプロパティが維持されるように、スライドの背景を変更する必要があります。フィールドを使用パフォーマンスも向上します

または、UpdatePagePropertiesRequest メソッドを使用して、背景を無地に変更できます。

スライドの背景画像を設定するためのリクエストプロトコルは次のとおりです。

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

サムネイルを生成

特定のページの最新バージョンのサムネイルをプレゼンテーションの presentations.pages.getThumbnail メソッドを呼び出し、ページのサムネイル画像をコンテンツ URL として返します。イメージ URL のデフォルトの有効期間は 30 分です。

次のように、返された mimeType と thumbnailSize を指定することもできます。 ThumbnailProperties フィールドをクエリパラメータとして渡します。

URL とともにページのサムネイルを生成するリクエストプロトコルは次のとおりです。 ThumbnailProperties セット:

 GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM

{
  "width": 800,
  "height": 450,
  "contentUrl": "CONTENT_URL"
}