기본 쓰기

Google Slides API를 사용하면 프레젠테이션 페이지에 요소를 추가하고 수정할 수 있습니다. 이 이 페이지의 예시는 presentations.batchUpdate 드림 메서드를 사용하여 축소하도록 요청합니다.

이 예에서는 다음 변수를 사용합니다.

  • PRESENTATION_ID: 프레젠테이션 ID를 입력합니다. 다음을 수행할 수 있습니다. 이 ID에 대한 값을 검색합니다.
  • PAGE_ID: 페이지 객체를 제공하는 위치를 나타냅니다. ID를 입력합니다. 다음을 가져올 수 있습니다. 이 값에 대한 값을 URL에서 가져오거나 API 읽기 요청을 사용하여 가져올 수 있습니다.
  • PAGE_ELEMENT_ID: 페이지를 제공하는 위치를 나타냅니다. 요소 객체 ID를 포함해야 합니다. 나 만든 요소에 대해 이 ID를 지정할 수 있습니다 (일부 제한사항) Slides API에서 자동으로 만들도록 허용할 수 있습니다. 요소 ID API 읽기 요청을 통해 가져올 수 있습니다.

이 예는 언어 중립을 위해 HTTP 요청으로 제공됩니다. 배우기 위해 Google API를 사용하여 다양한 언어로 일괄 업데이트를 구현하는 방법 자세한 내용은 도형 추가 및 텍스트를 입력합니다.

슬라이드에 텍스트 상자 추가하기

다음 presentations.batchUpdate 드림 코드 샘플을 사용하여 CreateShapeRequest 메서드를 사용하여 새 텍스트 상자('내가 추가한 텍스트 상자'라는 문자열 포함)를 PAGE_ID에서 지정한 슬라이드입니다. 두 개의 요청은 요청 본문 - 텍스트 상자 도형 (주어진 크기와 위치)를 입력하고 두 번째 버튼을 클릭하여 여기에 텍스트를 삽입합니다.

첫 번째 요청은 객체에서 사용할 ID 입력합니다. 이렇게 하면 두 번째 요청이 동일한 API 호출에서 이를 사용할 수 있으므로 발생할 수 있습니다

다음은 슬라이드에 텍스트 상자를 추가하는 요청 프로토콜입니다.

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createShape": {
        "objectId": PAGE_ELEMENT_ID,
        "shapeType": "TEXT_BOX",
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 150,
              "unit": "PT"
            },
            "height": {
              "magnitude": 50,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "My Added Text Box",
        "insertionIndex": 0
      }
    }
  ]
}

슬라이드에 이미지 추가

다음 presentations.batchUpdate 드림 코드 샘플을 사용하여 CreateImageRequest 메서드를 사용하여 PAGE_ID에서 지정한 슬라이드에 이미지를 추가합니다. 이 API가 IMAGE_URL를 사용하여 이미지를 가져옵니다. 이 요청은 또한 슬라이드에서 이미지의 크기를 조정하고 위치를 지정합니다.

다음은 슬라이드에 이미지를 추가하는 요청 프로토콜입니다.

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createImage": {
        "url": IMAGE_URL,
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 30,
              "unit": "PT"
            },
            "height": {
              "magnitude": 30,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    }
  ]
}

페이지 또는 페이지 요소 삭제

다음 presentations.batchUpdate 드림 코드 샘플을 사용하여 DeleteObjectRequest PAGE_ELEMENT_ID로 지정된 페이지 요소를 삭제하는 메서드 두 개의 개별 요청을 사용하여 PAGE_ID로 지정된 슬라이드입니다.

다음은 페이지 또는 페이지 요소를 삭제하는 요청 프로토콜입니다.

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      },
      "deleteObject": {
        "objectId":  PAGE_ID
      }
    }
  ]
}

지정된 도형에서 텍스트 수정

다음 presentations.batchUpdate 드림 코드 샘플을 사용하여 DeleteTextRequest 메서드를 사용하여 지정된 도형에 나타나는 텍스트의 일부를 PAGE_ELEMENT_ID 이렇게 하려면 먼저 0부터 시작하는 startIndex를 사용하고 그 위치에 새 텍스트를 삽입합니다. 이 예를 들어 원본 텍스트 문자열 'My Shape Text: ????'는 '내 도형 텍스트: 사다리꼴'.

이 요청은 지정된 도형의 텍스트에만 영향을 미칩니다. 모든 곳에서 텍스트 바꾸기 를 사용하려면 ReplaceAllTextRequest 드림 메서드를 사용하여 축소하도록 요청합니다.

다음은 지정된 도형에서 텍스트를 수정하는 요청 프로토콜입니다.

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteText": {
        "objectId": PAGE_ELEMENT_ID,
        "textRange": {
          "type": "FROM_START_INDEX",
          "startIndex": 15
        }
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "Trapezoid",
        "insertionIndex": 15
      }
    }
  ]
}

도형 태그를 이미지로 바꾸기

태그는 고유 문자열 이름이 있는 텍스트 상자나 도형입니다(예: 'account-owner-name'입니다.

다음 presentations.batchUpdate 드림 코드 샘플을 사용하여 CreateImageRequest 메서드를 사용하여 도형 태그의 단일 인스턴스를 이미지로 대체할 수 있습니다. 이미지의 크기를 유지하면서 태그 크기에 맞게 크기를 조절합니다. 가로세로 비율

이 요청을 사용하여 한 이미지를 다른 이미지로 바꿀 수도 있습니다. 요청 새 이미지를 추가한 다음 태그를 삭제하는 단계로 구성됩니다.

CreateImageRequest 메서드는 지정된 도형만 바꿉니다. 태그 교체 방법 사용하려면 ReplaceAllShapesWithImageRequest 드림 메서드를 사용하여 축소하도록 요청합니다.

도형 태그에는 다음이 있습니다. PageElement 드림 속성( presentations.pages.get 요청):

{
  "objectId": PAGE_ELEMENT_ID,
  "size": {
    "width": {
      "magnitude": 3000000,
      "unit": "EMU"
    },
    "height": {
      "magnitude": 3000000,
      "unit": "EMU"
    }
  },
  "transform": {
    "scaleX": 1.13,
    "scaleY": 0.62,
    "translateX": 4800000,
    "translateY":  450000,
    "unit": "EMU"
  },
  "shape": {
    "shapeType": "RECTANGLE"
  }
}

도형은 PAGE_ID로 지정된 슬라이드에 있습니다. 지정 셰이프를 대체하는 이미지인 경우, API는 IMAGE_URL 이미지의 가로 세로 비율을 제한하면서 비율을 유지하기 위해 태그 크기와 CreateImageRequest 드림 메서드는 이미지 크기를 태그 크기와 배율의 곱으로 설정하고 이미지 배율을 1로 설정합니다. 자세한 내용은 측면 보존을 참조하세요. 비율을 사용합니다.

다음은 도형 태그를 이미지로 대체하는 요청 프로토콜입니다.

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createImage": {
        "url": IMAGE_URL,
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 3000000 * 1.13,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 3000000 * 0.62,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 4800000,
            "translateY": 450000,
            "unit": "PT"
          }
        }
      }
    },
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      }
    }
  ]
}