Google Slides API を使用すると、線をまっすぐに保ち、点と平行線を保持しながら、ページ上の PageElement（テキスト ボックス、画像、表、基本図形）の位置、サイズ、向きを操作できます。これらは、アフィン変換と呼ばれます。次の例は、presentations.batchUpdate メソッドを使用した一般的なページ要素変換オペレーションを示しています。
これらの例では、次の変数を使用します。
- PRESENTATION_ID - プレゼンテーション ID を指定する場所を示します。この ID の値は、プレゼンテーションの URL から確認できます。
- PAGE_ID - ページ オブジェクト ID を指定する場所を示します。この値は、URL から取得することも、API 読み取りリクエストを使用して取得することもできます。
- PAGE_ELEMENT_ID - ページ要素オブジェクト ID を指定する場所を示します。作成する要素にこの ID を指定することも（一部の制限あり）、Slides API に自動的に作成させることもできます。要素 ID は、API 読み取りリクエストで取得できます。
これらの例は、言語に依存しない HTTP リクエストとして示されています。Google API クライアント ライブラリを使用してさまざまな言語でバッチ更新を実装する方法については、シェイプとテキストを追加するをご覧ください。
矢印の形状の例
以下の例では、次のサイズと変換データ（presentations.pages.get メソッド リクエストで確認できます）を持つ矢印形状のページ要素の例が存在するとします。この例の図形では、測定値に unit EMU（英国のメートル単位）と pt（ポイント）を使用しています。
{
"objectId": PAGE_ELEMENT_ID,
"size": {
"width": {
"magnitude": 3000000,
"unit": "EMU"
},
"height": {
"magnitude": 3000000,
"unit": "EMU"
}
},
"transform": {
"scaleX": 0.3,
"scaleY": 0.12,
"shearX": 0,
"shearY": 0,
"translateX": 2000000,
"translateY": 550000,
"unit": "EMU"
},
"shape": {
"shapeType": "RIGHT_ARROW"
}
}要素を別の要素と揃える
次の presentations.batchUpdate コードサンプルは、CreateShapeRequest メソッドを使用して、ページ上の矢印の例と位置が揃うように、正しい位置に新しいシェイプを作成する方法を示しています。どちらの場合も、新しいシェイプの左上の X 座標と Y 座標を計算する必要があります。
最初のリクエストでは、矢印シェイプの左側の境界線に沿って 100 x 50 pt の長方形が作成されますが、矢印の上端から 50 pt（50 x 12,700 = 635,000 EMU）下に配置されます。新しい長方形の X 座標は、矢印の X 座標と同じにする必要があります。これにより、左側の境界が揃います。距離は矢印の上部から測定されるため、Y 座標は矢印の Y 座標に 50 pt を加えた値と同じです。したがって、長方形の座標は次のようになります。
x" = 2000000 EMU y" = 550000 + (50 * 12700) = 1185000 EMU
2 番目のリクエストでは、例の矢印と同じ水平の中心線を持つ 40 pt 幅の円を作成しますが、矢印の右端の右側に 100 pt（1,270,000 EMU）配置します。円の X 座標は、矢印の X 座標、矢印の幅、100 pt の合計です。新しい円の中心線を合わせるには、矢印と円の両方の高さを考慮する必要があります。円の Y 座標は、矢印の Y 座標に矢印の高さの半分と円の高さの半分を足した値です。どちらの場合も、矢印に関連付けられたスケーリング ファクタも考慮する必要があります。これは、矢印のレンダリングされる幅と高さに影響するためです。したがって、円の座標は次のようになります。
x = 2000000 + (0.3 * 3000000) + (100 * 12700) = 4170000 EMU y = 550000 + (0.5 * 0.12 * 3000000) - (0.5 * 40 * 12700) = 476000 EMU
要素を別の要素と位置合わせするためのリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createShape": {
"shapeType": "RECTANGLE",
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 100,
"unit": "PT"
},
"height": {
"magnitude": 50,
"unit": "PT"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 2000000,
"translateY": 1185000,
"unit": "EMU"
}
}
}
},
{
"createShape": {
"shapeType": "ELLIPSE",
"elementProperties": {
"pageObjectId": PAGE_ID,
"size": {
"width": {
"magnitude": 40,
"unit": "PT"
},
"height": {
"magnitude": 40,
"unit": "PT"
}
},
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 4170000,
"translateY": 476000,
"unit": "EMU"
}
}
}
}
]
}要素を移動する
次の presentations.batchUpdate コードサンプルは、UpdatePageElementTransformRequest メソッドを使用して、矢印の形状の例ページ要素を 2 つの異なる方法で移動する方法を示しています。
バッチ内の最初のリクエストは、矢印を（X,Y）=（2000000, 150000）EMU 座標に移動します（絶対変換
applyMode を使用）。バッチ内の 2 番目のリクエストは、矢印をそこから右に 40,000 EMU、上に 35,000 EMU 移動します（相対変換 applyMode を使用）。使用されるtransformation1 マトリックスは、要素のサイズと向きを変更しないように作成されています。
両方のリクエストを実行すると、矢印の左上隅は（X,Y）=（2040000, 115000）EMU 座標になります。
要素を移動するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updatePageElementTransform": {
"objectId": PAGE_ELEMENT_ID,
"applyMode": "ABSOLUTE",
"transform": {
"scaleX": 0.3,
"scaleY": 0.12,
"translateX": 2000000,
"translateY": 150000,
"unit": "EMU"
}
}
},
{
"updatePageElementTransform": {
"objectId": PAGE_ELEMENT_ID,
"applyMode": "RELATIVE",
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 40000,
"translateY": -35000,
"unit": "EMU"
}
}
}
]
}要素を反映する
次の presentations.batchUpdate コードサンプルは、UpdatePageElementTransformRequest メソッドを使用して、ページ上の位置やスケーリングを変更せずに、矢印の形の例のページ要素を中央に水平方向に反射する方法を示しています。
これは、要素の参照フレームで基本的な反射変換を使用することで行われます。わかりやすくするため、参照フレームのシフトと反射は、UpdatePageElementTransformRequest メソッドを 3 回呼び出して示していますが、これらの変換行列の積を事前に計算し、その積を 1 つのリクエストとして適用する方が効率的です。
移動変換では、矢印の中心が原点との間で移動します。パラメータ値はわかりやすく計算式で表しています。
要素を反映するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updatePageElementTransform": {
"objectId": PAGE_ELEMENT_ID,
"applyMode": "RELATIVE",
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": -2000000 - 0.5 * 0.3 * 3000000,
"translateY": -550000 - 0.5 * 0.12 * 3000000,
"unit": "EMU"
}
}
},
{
"updatePageElementTransform": {
"objectId": PAGE_ELEMENT_ID,
"applyMode": "RELATIVE",
"transform": {
"scaleX": -1,
"scaleY": 1,
"unit": "EMU"
}
}
},
{
"updatePageElementTransform": {
"objectId": PAGE_ELEMENT_ID,
"applyMode": "RELATIVE",
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 2000000 + 0.5 * 0.3 * 3000000,
"translateY": 550000 + 0.5 * 0.12 * 3000000,
"unit": "EMU"
}
}
}
]
}要素のサイズを変更する
次の presentations.batchUpdate コードサンプルは、UpdatePageElementTransformRequest メソッドを使用して、矢印の中心を同じ位置に保ち、向きを維持しながら、矢印の形状の例ページ要素の幅を 50% 広げ、現在の高さの 80% に縮小する方法を示しています。
これは、要素の参照フレームで基本的なスケーリング変換を使用することによって行われます。わかりやすくするため、参照フレームのシフトとスケーリングは、UpdatePageElementTransformRequest メソッドを 3 回呼び出して示していますが、これらの変換行列の積を事前に計算し、その積を 1 つのリクエストとして適用する方が効率的です。
移動変換では、矢印の中心が原点との間で移動します。パラメータ値はわかりやすく計算式で表しています。
要素のサイズを変更するリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updatePageElementTransform": {
"objectId": PAGE_ELEMENT_ID,
"applyMode": "RELATIVE",
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": -2000000 - 0.5 * 0.3 * 3000000,
"translateY": -550000 - 0.5 * 0.12 * 3000000,
"unit": "EMU"
}
}
},
{
"updatePageElementTransform": {
"objectId": PAGE_ELEMENT_ID,
"applyMode": "RELATIVE",
"transform": {
"scaleX": 1.5,
"scaleY": 0.8,
"unit": "EMU"
}
}
},
{
"updatePageElementTransform": {
"objectId": PAGE_ELEMENT_ID,
"applyMode": "RELATIVE",
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 2000000 + 0.5 * 0.3 * 3000000,
"translateY": 550000 + 0.5 * 0.12 * 3000000,
"unit": "EMU"
}
}
}
]
}要素の中心を中心に回転する
次の presentations.batchUpdate コードサンプルは、UpdatePageElementTransformRequest メソッドを使用して、矢印の中心を同じ位置に保ち、サイズを維持しながら、矢印の形状の例ページ要素を反時計回りに 35 度回転させる方法を示しています。
これは、要素の参照フレームで基本的な回転変換を使用して行います。わかりやすくするため、参照フレームのシフトと回転は UpdatePageElementTransformRequest メソッドを 3 回呼び出して示していますが、これらの変換行列の積を事前に計算し、その積を 1 つのリクエストとして適用する方が効率的です。
移動変換では、矢印の中心が原点との間で移動します。パラメータ値はわかりやすく計算式で表しています。
要素の中心を軸にして回転させるリクエスト プロトコルは次のとおりです。
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"updatePageElementTransform": {
"objectId": PAGE_ELEMENT_ID,
"applyMode": "RELATIVE",
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": -2000000 - 0.5 * 0.3 * 3000000,
"translateY": -550000 - 0.5 * 0.12 * 3000000,
"unit": "EMU"
}
}
},
{
"updatePageElementTransform": {
"objectId": PAGE_ELEMENT_ID,
"applyMode": "RELATIVE",
"transform": {
"scaleX": cos(35 * (pi/180)),
"scaleY": cos(35 * (pi/180)),
"shearX": sin(35 * (pi/180)),
"shearY": -sin(35 * (pi/180)),
"unit": "EMU"
}
}
},
{
"updatePageElementTransform": {
"objectId": PAGE_ELEMENT_ID,
"applyMode": "RELATIVE",
"transform": {
"scaleX": 1,
"scaleY": 1,
"translateX": 2000000 + 0.5 * 0.3 * 3000000,
"translateY": 550000 + 0.5 * 0.12 * 3000000,
"unit": "EMU"
}
}
}
]
}