PPAPI: Add an API for setting a custom user agent for URL requests.

ppapi/api/ppb_url_request_info.idl

 /* Copyright (c) 2012 The Chromium Authors. All rights reserved.
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 /**
  * This file defines the <code>PPB_URLRequestInfo</code> API for creating and
  * manipulating URL requests.
  */
 
@@ skipping 122 matching lines @@
    * not defined and is set by the browser to a value appropriate for the
    * default <code>PP_URLREQUESTPROPERTY_PREFETCHBUFFERUPPERTHRESHOLD</code>.
    * Set it to an integer to set a lower threshold for the prefetched buffer
    * of an asynchronous load. When reached, the browser will resume loading if
    * If <code>PP_URLREQUESTPROPERTY_PREFETCHBUFFERLOWERERTHRESHOLD</code> had
    * previously been reached.
    * When setting this property,
    * <code>PP_URLREQUESTPROPERTY_PREFETCHBUFFERUPPERTHRESHOLD</code> must also
    * be set. Behavior is undefined if the former is >= the latter.
    */
-  PP_URLREQUESTPROPERTY_PREFETCHBUFFERLOWERTHRESHOLD = 12
+  PP_URLREQUESTPROPERTY_PREFETCHBUFFERLOWERTHRESHOLD = 12,
+
+  /**
+   * This corresponds to a string (<code>PP_VARTYPE_STRING</code>) or may be
+   * undefined (<code>PP_VARTYPE_UNDEFINED</code>; default). Set it to a string
+   * to set a custom user-agent header (if empty, that header will be omitted),
+   * or to undefined to use the default. Only loaders with universal access
+   * (only available on trusted implementations) will accept
+   * <code>URLRequestInfo</code> objects that try to set a custom user agent; if
+   * given to a loader without universal access, <code>PP_ERROR_NOACCESS</code>
+   * will result.
+   */
+  PP_URLREQUESTPROPERTY_CUSTOMUSERAGENT = 13
 };
 
 /**
  * The <code>PPB_URLRequestInfo</code> interface is used to create
  * and handle URL requests. This API is used in conjunction with
  * <code>PPB_URLLoader</code>. Refer to <code>PPB_URLLoader</code> for further
  * information.
  */
 interface PPB_URLRequestInfo {
   /**
@@ skipping 83 matching lines @@
    * of the parameters are invalid.
    */
   PP_Bool AppendFileToBody(
       [in] PP_Resource request,
       [in] PP_Resource file_ref,
       [in] int64_t start_offset,
       [in] int64_t number_of_bytes,
       [in] PP_Time expected_last_modified_time);
 };