Temel yazma

Google Slaytlar API'si, sunu sayfalarına öğe eklemenize ve mevcut öğeleri değiştirmenize olanak tanır. İlgili içeriği oluşturmak için kullanılan Bu sayfadaki örneklerde presentations.batchUpdate yöntemidir.

Bu örneklerde aşağıdaki değişkenler kullanılmaktadır:

Bu örnekler, dilden bağımsız olarak HTTP istekleri olarak sunulur. Öğrenmek için Google API kullanılarak farklı dillerde toplu güncelleme uygulama Şekil ekleme ve metin.

Slayta metin kutusu ekleme

Aşağıdakiler presentations.batchUpdate kod örneği, CreateShapeRequest bir yönteme yeni bir metin kutusu ("Eklediğim Metin Kutusu" dizesini içerir) PAGE_ID tarafından belirtilen slayt. Şurada iki talep belirtilmiştir: istek gövdesi-metin kutusu şeklini oluşturmak için (belirli bir boyut ve yer), bir saniye de metin eklemek için kullanılır.

İlk istek, nesneyi belirtir. Şunun için kullanılacak kimlik: girin. Bu, ikinci isteğin bunu aynı API çağrısında kullanmasına olanak tanır ve böylece yardımcı olabilir.

Slayta metin kutusu eklemek için kullanılacak istek protokolü aşağıda verilmiştir:

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
      }
    }
  ]
}

Slayta resim ekleme

Aşağıdakiler presentations.batchUpdate kod örneği, CreateImageRequest yönteminde PAGE_ID ile belirtilen bir slayda resim ekleyebilirsiniz. İlgili içeriği oluşturmak için kullanılan API, görüntüyü IMAGE_URL kullanarak alır. Bu istek ayrıca ve slayttaki resmi ölçeklendirir ve konumlandırır.

Slayta resim eklemek için kullanılacak istek protokolü aşağıda verilmiştir:

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"
          }
        }
      }
    }
  ]
}

Bir sayfa veya sayfa öğesini silme

Aşağıdakiler presentations.batchUpdate kod örneği, DeleteObjectRequest PAGE_ELEMENT_ID tarafından belirtilen sayfa öğesini silme yöntemi ve PAGE_ID tarafından belirtilen slayt.

Aşağıda, bir sayfa veya sayfa öğesini silmek için kullanılan istek protokolü verilmiştir:

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

Belirtilen şekildeki metni düzenleme

Aşağıdakiler presentations.batchUpdate kod örneği, DeleteTextRequest yöntemini değiştirme yöntemini kullanarak, PAGE_ELEMENT_ID. Bunu yapmak için önce tabanlı startIndex yer alır ve ardından bu konuma yeni metin ekler. Burada Örneğin, "Şekil Metnim: ????" orijinal metin dizesi "My Şekil Metni: Yamuk".

Bu istek yalnızca belirtilen bir şekildeki metni etkiler. Metni her yerde değiştirmek için sunum içinde ReplaceAllTextRequest yöntemidir.

Aşağıda, belirtilen bir şekilde metni düzenlemek için kullanılan istek protokolü verilmiştir:

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
      }
    }
  ]
}

Şekil etiketini resimle değiştirme

Etiketler, "hesap-sahibi-adı".

Aşağıdakiler presentations.batchUpdate kod örneği, CreateImageRequest bir şekil etiketinin tek bir örneğini bir resimle değiştirme yönteminde ve etiketin boyutuna sığacak şekilde ölçeklendirmek, aynı zamanda bunu en boy oranı.

İstek, bir resmi başka bir resimle değiştirmek için de kullanılabilir. İstek yeni resmin eklenmesi ve ardından etiketin silinmesinden oluşur.

CreateImageRequest yöntemi yalnızca belirtilen bir şeklin yerine geçer. Etiketi değiştirmek için bir sunudaki her yerde farklı şekiller varsa, ReplaceAllShapesWithImageRequest yöntemidir.

Şekil etiketi aşağıdakilere sahiptir PageElement (Bu bilgiler presentations.pages.get isteyebilirsiniz):

{
  "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"
  }
}

Şekil, PAGE_ID tarafından belirtilen slaytta bulunur. Belirtmek için: resmin yerini alan resmi alırsa API, resmi IMAGE_URL Sınırlarken resmin en boy oranını korumak için etiketin boyutuna göre, CreateImageRequest yöntemi, hem resim boyutunu hem etiket boyutu hem de ölçeğinin çarpımına ayarlar ve Resim ölçeği, 1 hesaplanır. Daha fazla bilgi için Detaylı içeriği koruma oranı'nı inceleyin.

Aşağıda, bir şekil etiketini resimle değiştirmek için gereken istek protokolü gösterilmektedir:

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
      }
    }
  ]
}