[omaha] r170 committed - Edited wiki page ServerProtocolV3 through web user interface.

[om...@googlecode.com]

Revision: 170
Author: waf...@google.com
Date: Thu Apr 2 18:02:01 2015 UTC
Log: Edited wiki page ServerProtocolV3 through web user interface.
https://code.google.com/p/omaha/source/detail?r=170

Modified:
/wiki/ServerProtocolV3.wiki

=======================================
--- /wiki/ServerProtocolV3.wiki Thu Feb 19 00:41:23 2015 UTC
+++ /wiki/ServerProtocolV3.wiki Thu Apr 2 18:02:01 2015 UTC
@@ -147,6 +147,10 @@
* `installsource`: A string indicating the cause of this install or
update flow. As examples: "organic" indicating an organic web
download, "scheduler" indicating a scheduled update, "ondemand" indicating
a user-prompted update. Default: "".
* `tag`: An field for a client to transmit arbitrary update parameters
in string form. Compatible clients and servers MAY use this attribute to
negotiate special update rules. Alternatively, they MAY extend the protocol
to represent the information more clearly in another parameter. As an
example, Omaha Client uses this field to transmit whether a Google Chrome
installation is on the "stable", "dev", or "beta" channel, which affects
how the server issues update responses for that installation. Default: "".
* `fingerprint`: If there is only one package, the fingerprint for that
package may be transmitted at the `<app>` level. See
[#Packages_&_Fingerprints]. Default: "".
+ * `cohort`: A machine-readable string identifying the release cohort
(channel) that the app belongs to. Limited to ASCII characters 32 to 127
(inclusive) and a maximum length of 1024 characters. Default: "".
+ * `cohorthint`: An machine-readable enum indicating that the client has
a desire to switch to a different release cohort. The exact legal values
are app-specific and should be shared between the server and app
implementations. Limited to ASCII characters 32 to 127 (inclusive) and a
maximum length of 1024 characters. Default: "".
+ * `cohortname`: A stable machine-readable enum indicating which (if
any) set of messages the app should display to the user. For example, an
app with a cohortname of "beta" might display beta-specific branding to the
user. Limited to ASCII characters 32 to 127 (inclusive) and a maximum
length of 1024 characters. Default: "".
+
===== Legal Child Elements =====
* Any number of `<data>`.
* Any number of `<disabled>`.
@@ -301,6 +305,9 @@
* `appid`:
* `status`:
* `experiments`:
+ * `cohort`: See cohort in the request. If this attribute is transmitted
in the response (even if the value is empty-string), the client should
overwrite the current cohort of this app with the sent value. Limited to
ASCII characters 32 to 127 (inclusive) and a maximum length of 1024
characters. No default value.
+ * `cohorthint`: See cohorthint in the request. If sent (even if the
value is empty-string), the client should overwrite the current cohorthint
of this app with the sent value. Limited to ASCII characters 32 to 127
(inclusive) and a maximum length of 1024 characters. No default value.
+ * `cohortname`: See cohortname in the request. If sent (even if the
value is empty-string), the client should overwrite the current cohortname
of this app with the sent value. Limited to ASCII characters 32 to 127
(inclusive) and a maximum length of 1024 characters. No default value.
===== Legal Child Elements =====
* At most one `<ping>`.
* Any number of `<data>`.