8 Appendix C: Product Behavior

Office

The information in this specification is applicable to the following Microsoft products or supplemental software. References to product versions include released service packs.

  • Microsoft PowerPoint 2010

  • Microsoft PowerPoint Online

  • Microsoft PowerPoint 2013

  • Microsoft PowerPoint 2016

Exceptions, if any, are noted below. If a service pack or Quick Fix Engineering (QFE) number appears with the product version, behavior changed in that service pack or QFE. The new behavior also applies to subsequent service packs of the product unless otherwise specified. If a product edition appears with the product version, behavior is different in that product edition.

Unless otherwise specified, any statement of optional behavior in this specification that is prescribed using the terms SHOULD or SHOULD NOT implies product behavior in accordance with the SHOULD or SHOULD NOT prescription. Unless otherwise specified, the term MAY implies that the product does not follow the prescription.

<1> Section 2.1:  PowerPoint Online servers support JSON [RFC4627] over HTTP and HTTPS.

<2> Section 2.2.4:  Support for this complex type was added in Microsoft Office 2013.

<3> Section 2.2.4:  Support for this complex type was added in Office 2013.

<4> Section 2.2.4:  Support for this complex type was added in Office 2013.

<5> Section 2.2.4:  Support for this complex type was added in Office 2013.

<6> Section 2.2.4:  Support for this complex type was added in Office 2013.

<7> Section 2.2.4:  Support for this type was added in Microsoft Office 2010 suites Service Pack 1.

<8> Section 2.2.4:  Support for this complex type was added in Office 2013.

<9> Section 2.2.4:  Support for this complex type was added in Office 2013.

<10> Section 2.2.4:  Support for this complex type was added in Office 2013.

<11> Section 2.2.4:  Support for this complex type was added in Office 2013.

<12> Section 2.2.4:  Support for this complex type was added in Office 2013.

<13> Section 2.2.4:  Support for this complex type was added in Office 2013.

<14> Section 2.2.4:  Support for this type was added in Office 2010 Service Pack 1.

<15> Section 2.2.4:  Support for this complex type was added in Office 2013.

<16> Section 2.2.4:  Support for this type was added in Office 2013.

<17> Section 2.2.4:  Support for this complex type was added in Office 2013.

<18> Section 2.2.4.1:  Support for this complex type was added in Office 2013.

<19> Section 2.2.4.3:  Support for this complex type was added in Office 2013.

<20> Section 2.2.4.4:  Support for this complex type was added in Office 2013.

<21> Section 2.2.4.12:  Support for this complex type was added in Office 2013.

<22> Section 2.2.4.15:  Support for this complex type was added in Office 2013.

<23> Section 2.2.4.16:  Support for this type was added in Office 2010 Service Pack 1.

<24> Section 2.2.4.17:  Support for this complex type was added in Office 2013.

<25> Section 2.2.4.18:  Support for this complex type was added in Office 2013.

<26> Section 2.2.4.19:  Support for this complex type was added in Office 2013.

<27> Section 2.2.4.22:  Support for this complex type was added in Office 2013.

<28> Section 2.2.4.24:  Support for this complex type was added in Office 2013.

<29> Section 2.2.4.25:  Support for this element was added in Office 2010 Service Pack 1.

<30> Section 2.2.4.26:  Support for this element was added in Office 2010 Service Pack 1.

<31> Section 2.2.4.32:  Support for this complex type was added in Office 2013.

<32> Section 2.2.4.39:  Support for this type was added in Office 2010 Service Pack 1.

<33> Section 2.2.4.40:  Support for this complex type was added in Office 2013.

<34> Section 2.2.4.44:  Support for this type was added in Office 2013.

<35> Section 2.2.4.48:  Support for this complex type was added in Office 2013.

<36> Section 2.2.4.51:  PowerPoint Online defines this type as a string ([XMLSCHEMA2] section 3.2.1) that specifies the identifier of the image. 

To retrieve an image, the protocol client sends a request to the protocol server at the endpoint formed by appending "/_layouts/editImageHandler.ashx" to the URL of the website, for example http: //www.contoso.com/Repository/_layouts/editImageHandler.ashx.

The parameters to the endpoint are specified by the following table:

Parameter name

Definition

Rid

MUST be ImgId as specified by ViewElement (section 2.2.4.51).

Pid

MUST be a valid identifier for a presentation as specified in GetPresentationId (section 3.1.4.27).

<37> Section 3.1.3:  The URL conforms to the following structure in Office 2010: base URL/_vti_bin/ppt/edit.svc

<38> Section 3.1.3:  The insert picture operation is used to insert a picture into a presentation.

In Office 2010, the protocol server endpoint to insert picture content is formed by appending "/_layouts/pptInsertPicture.ashx" to the URL of the website, for example http://www.contoso.com/_layouts/pptInsertPicture.ashx.

In Office 2013, the protocol server endpoint to insert picture content is formed by appending "/p/pptInsertPicture.ashx" to the base URL, for example http://www.contoso.com/p/pptInsertPicture.ashx.

The parameters to the endpoint are specified by the following table:

Parameter name

Definition

PresentationId

MUST be a valid identifier of a presentation as specified by section 3.1.4.27.

SlideId

MUST be a valid ST_SlideId ([ISO/IEC29500-1:2011] section 19.7.13) that specifies the identifier of the presentation slide

ShapeId

MUST be a valid ST_DrawingElementId ([ISO/IEC29500-1:2011] section 20.1.10.21) that specifies the identifier of the shape.

<39> Section 3.1.4:  Support for this operation was added in Office 2013.

<40> Section 3.1.4:  Support for this operation was added in Office 2013.

<41> Section 3.1.4:  Support for this operation was added in Office 2013.

<42> Section 3.1.4:  Support for this operation was added in Office 2013.

<43> Section 3.1.4:  Support for this operation was added in Office 2013.

<44> Section 3.1.4:  Support for this operation was added in Office 2013.

<45> Section 3.1.4:  Support for this operation was added in Office 2013.

<46> Section 3.1.4:  Support for this operation was added in Office 2010 Service Pack 1.

<47> Section 3.1.4:  Support for this operation was added in Office 2013.

<48> Section 3.1.4:  Support for this operation was added in Office 2013.

<49> Section 3.1.4:  Support for this operation was added in Office 2013.

<50> Section 3.1.4:  Support for this operation was added in Office 2013.

<51> Section 3.1.4:  Support for this operation was added in Office 2013.

<52> Section 3.1.4:  Support for this operation was added in Office 2013.

<53> Section 3.1.4:  Support for this operation was added in Office 2013.

<54> Section 3.1.4:  Support for this operation was added in Office 2010 Service Pack 1.

<55> Section 3.1.4:  Support for this operation was added in Office 2013.

<56> Section 3.1.4:  Support for this operation was added in Office 2013.

<57> Section 3.1.4:  Support for this operation was added in Office 2013.

<58> Section 3.1.4:  Support for this operation was added in Office 2010 Service Pack 1.

<59> Section 3.1.4:  Support for this operation was added in Office 2013.

<60> Section 3.1.4:  Support for this operation was added in Office 2013.

<61> Section 3.1.4:  Support for this operation was added in Office 2013.

<62> Section 3.1.4:  Support for this operation was added in Office 2013.

<63> Section 3.1.4:  Support for this operation was added in Office 2013.

<64> Section 3.1.4:  Support for this operation was added in Office 2013.

<65> Section 3.1.4:  Support for this operation was added in Office 2013.

<66> Section 3.1.4:  Support for this operation was added in Office 2013.

<67> Section 3.1.4:  Support for this operation was added in Office 2013.

<68> Section 3.1.4:  Support for this operation was added in Office 2013.

<69> Section 3.1.4:  Support for this operation was added in Office 2013.

<70> Section 3.1.4.1:  Support for this operation was added in Office 2013.

<71> Section 3.1.4.2:  Support for this operation was added in Office 2013.

<72> Section 3.1.4.3:  Support for this operation was added in Office 2013.

<73> Section 3.1.4.4:  Support for this operation was added in Office 2013.

<74> Section 3.1.4.5:  Support for this operation was added in Office 2013.

<75> Section 3.1.4.6:  Support for this operation was added in Office 2013.

<76> Section 3.1.4.7:  Support for this operation was added in Office 2013.

<77> Section 3.1.4.8:  Support for this operation was added in Office 2010 Service Pack 1.

<78> Section 3.1.4.9:  Support for this operation was added in Office 2013.

<79> Section 3.1.4.16:  Support for this operation was added in Office 2013.

<80> Section 3.1.4.18:  Support for this operation was added in Office 2013.

<81> Section 3.1.4.20:  Support for this operation was added in Office 2013.

<82> Section 3.1.4.21:  Support for this operation was added in Office 2013.

<83> Section 3.1.4.22:  Support for this operation was added in Office 2013.

<84> Section 3.1.4.24:  Support for this operation was added in Office 2013.

<85> Section 3.1.4.28:  Support for this operation was added in Office 2010 Service Pack 1.

<86> Section 3.1.4.29:  Support for this operation was added in Office 2013.

<87> Section 3.1.4.33:  Support for this operation was added in Office 2013.

<88> Section 3.1.4.34:  Support for this operation was added in Office 2013.

<89> Section 3.1.4.37:  Support for this operation was added in Office 2010 Service Pack 1.

<90> Section 3.1.4.39:  Support for this operation was added in Office 2013.

<91> Section 3.1.4.40:  Support for this operation was added in Office 2013.

<92> Section 3.1.4.41:  Support for this operation was added in Office 2013.

<93> Section 3.1.4.44:  Support for this operation was added in Office 2013.

<94> Section 3.1.4.46:  Support for this operation was added in Office 2013.

<95> Section 3.1.4.48:  Support for this operation was added in Office 2013.

<96> Section 3.1.4.50:  Support for this operation was added in Office 2013.

<97> Section 3.1.4.60:  Support for this operation was added in Office 2013.

<98> Section 3.1.4.61:  Support for this operation was added in Office 2013.

<99> Section 3.1.4.63:  Support for this operation was added in Office 2013.

<100> Section 3.1.4.66:  Support for this operation was added in Office 2013.

<101> Section 5.1:  PowerPoint Online uses the canary mitigation as follows. On a request to GetPresentationId (section 3.1.4.27), an HTTP cookie with a name of X-Key is included in the response. The value of this cookie is then required to be included by subsequent operation calls that might result in a change to a presentation. For any subsequent operation, an additional cookie with the name X-NewKey can also be included which allows the protocol server to inform the protocol client of the new canary value, for example when the canary has expired.

Show: