8 Appendix C: Product Behavior

  • Article

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

  • Microsoft PowerPoint 2010

  • Microsoft PowerPoint Online

  • Microsoft PowerPoint 2013

  • Microsoft PowerPoint 2016

Exceptions, if any, are noted in this section. If an update version, service pack or Knowledge Base (KB) number appears with a product name, the behavior changed in that update. The new behavior also applies to subsequent updates 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 string ([XMLSCHEMA2] section 3.2.1) that specifies the identifier of the presentation slide as specified by ST_SlideId ([ISO/IEC29500-1:2016] section 19.7.13). 

ShapeId

MUST be a valid unsignedInt ([XMLSCHEMA2] section 3.3.22) that specifies the identifier of the shape as specified by ST_DrawingElementId ([ISO/IEC29500-1:2016] section 20.1.10.21).

<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.