Update docs (#291)

Author: saicheems

docs/dyn/acceleratedmobilepageurl_v1.ampUrls.html

@@ -111,7 +111,8 @@ <h3>Method Details</h3>
         # only once.
       { # AMP URL response for a requested URL.
         "ampUrl": "A String", # The AMP URL pointing to the publisher's web server.
-        "cdnAmpUrl": "A String", # The [AMP Cache URL](/amp/cache/overview#amp-cache-url-format) pointing to the cached document in the Google AMP Cache.
+        "cdnAmpUrl": "A String", # The [AMP Cache URL](/amp/cache/overview#amp-cache-url-format) pointing to
+            # the cached document in the Google AMP Cache.
         "originalUrl": "A String", # The original non-AMP URL.
       },
     ],

docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.html

@@ -126,7 +126,7 @@ <h3>Method Details</h3>
     "entityType": "A String", # The type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
     "role": "A String", # The role which is assigned to the client buyer. Each role implies a set of
         # permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,
-        # `CLIENT_DEAL_NEGOTIATOR`, or `CLIENT_DEAL_APPROVER`.
+        # `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
     "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
     "entityId": "A String", # Numerical identifier of the client entity.
         # The entity can be an advertiser, a brand, or an agency.
@@ -174,7 +174,7 @@ <h3>Method Details</h3>
       "entityType": "A String", # The type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
       "role": "A String", # The role which is assigned to the client buyer. Each role implies a set of
           # permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,
-          # `CLIENT_DEAL_NEGOTIATOR`, or `CLIENT_DEAL_APPROVER`.
+          # `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
       "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
       "entityId": "A String", # Numerical identifier of the client entity.
           # The entity can be an advertiser, a brand, or an agency.
@@ -230,7 +230,7 @@ <h3>Method Details</h3>
       "entityType": "A String", # The type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
       "role": "A String", # The role which is assigned to the client buyer. Each role implies a set of
           # permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,
-          # `CLIENT_DEAL_NEGOTIATOR`, or `CLIENT_DEAL_APPROVER`.
+          # `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
       "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
       "entityId": "A String", # Numerical identifier of the client entity.
           # The entity can be an advertiser, a brand, or an agency.
@@ -300,7 +300,7 @@ <h3>Method Details</h3>
           "entityType": "A String", # The type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
           "role": "A String", # The role which is assigned to the client buyer. Each role implies a set of
               # permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,
-              # `CLIENT_DEAL_NEGOTIATOR`, or `CLIENT_DEAL_APPROVER`.
+              # `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
           "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
           "entityId": "A String", # Numerical identifier of the client entity.
               # The entity can be an advertiser, a brand, or an agency.
@@ -368,7 +368,7 @@ <h3>Method Details</h3>
     "entityType": "A String", # The type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
     "role": "A String", # The role which is assigned to the client buyer. Each role implies a set of
         # permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,
-        # `CLIENT_DEAL_NEGOTIATOR`, or `CLIENT_DEAL_APPROVER`.
+        # `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
     "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
     "entityId": "A String", # Numerical identifier of the client entity.
         # The entity can be an advertiser, a brand, or an agency.
@@ -416,7 +416,7 @@ <h3>Method Details</h3>
       "entityType": "A String", # The type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
       "role": "A String", # The role which is assigned to the client buyer. Each role implies a set of
           # permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`,
-          # `CLIENT_DEAL_NEGOTIATOR`, or `CLIENT_DEAL_APPROVER`.
+          # `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
       "visibleToSeller": True or False, # Whether the client buyer will be visible to sellers.
       "entityId": "A String", # Numerical identifier of the client entity.
           # The entity can be an advertiser, a brand, or an agency.

docs/dyn/adexchangebuyer2_v2beta1.accounts.clients.invitations.html

@@ -99,8 +99,8 @@ <h3>Method Details</h3>
   body: object, The request body. (required)
     The object takes the form of:
 
-{ # An invitation for a new client user to get access to the AdExchange Buyer UI.
-      # 
+{ # An invitation for a new client user to get access to the Ad Exchange
+      # Buyer UI.
       # All fields are required unless otherwise specified.
     "clientAccountId": "A String", # Numerical account ID of the client buyer
         # that the invited user is associated with.
@@ -120,8 +120,8 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # An invitation for a new client user to get access to the AdExchange Buyer UI.
-        #
+    { # An invitation for a new client user to get access to the Ad Exchange
+        # Buyer UI.
         # All fields are required unless otherwise specified.
       "clientAccountId": "A String", # Numerical account ID of the client buyer
           # that the invited user is associated with.
@@ -151,8 +151,8 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # An invitation for a new client user to get access to the AdExchange Buyer UI.
-        #
+    { # An invitation for a new client user to get access to the Ad Exchange
+        # Buyer UI.
         # All fields are required unless otherwise specified.
       "clientAccountId": "A String", # Numerical account ID of the client buyer
           # that the invited user is associated with.
@@ -203,8 +203,8 @@ <h3>Method Details</h3>
         # method to retrieve the next
         # page of results.
     "invitations": [ # The returned list of client users.
-      { # An invitation for a new client user to get access to the AdExchange Buyer UI.
-            #
+      { # An invitation for a new client user to get access to the Ad Exchange
+            # Buyer UI.
             # All fields are required unless otherwise specified.
           "clientAccountId": "A String", # Numerical account ID of the client buyer
               # that the invited user is associated with.

docs/dyn/adexchangebuyer_v1_4.accounts.html

@@ -81,10 +81,10 @@ <h2>Instance Methods</h2>
   <code><a href="#list">list()</a></code></p>
 <p class="firstline">Retrieves the authenticated user's list of accounts.</p>
 <p class="toc_element">
-  <code><a href="#patch">patch(id, body)</a></code></p>
+  <code><a href="#patch">patch(id, body, confirmUnsafeAccountChange=None)</a></code></p>
 <p class="firstline">Updates an existing account. This method supports patch semantics.</p>
 <p class="toc_element">
-  <code><a href="#update">update(id, body)</a></code></p>
+  <code><a href="#update">update(id, body, confirmUnsafeAccountChange=None)</a></code></p>
 <p class="firstline">Updates an existing account.</p>
 <h3>Method Details</h3>
 <div class="method">
@@ -166,7 +166,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="patch">patch(id, body)</code>
+    <code class="details" id="patch">patch(id, body, confirmUnsafeAccountChange=None)</code>
   <pre>Updates an existing account. This method supports patch semantics.
 
 Args:
@@ -200,6 +200,7 @@ <h3>Method Details</h3>
     "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
   }
 
+  confirmUnsafeAccountChange: boolean, Confirmation for erasing bidder and cookie matching urls.
 
 Returns:
   An object of the form:
@@ -232,7 +233,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(id, body)</code>
+    <code class="details" id="update">update(id, body, confirmUnsafeAccountChange=None)</code>
   <pre>Updates an existing account.
 
 Args:
@@ -266,6 +267,7 @@ <h3>Method Details</h3>
     "cookieMatchingUrl": "A String", # The base URL used in cookie match requests.
   }
 
+  confirmUnsafeAccountChange: boolean, Confirmation for erasing bidder and cookie matching urls.
 
 Returns:
   An object of the form:

docs/dyn/adexchangebuyer_v1_4.creatives.html

@@ -86,6 +86,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#list">list(dealsStatusFilter=None, openAuctionStatusFilter=None, pageToken=None, maxResults=None, buyerCreativeId=None, accountId=None)</a></code></p>
 <p class="firstline">Retrieves a list of the authenticated user's active creatives. A creative will be available 30-40 minutes after submission.</p>
+<p class="toc_element">
+  <code><a href="#listDeals">listDeals(accountId, buyerCreativeId)</a></code></p>
+<p class="firstline">Lists the external deal ids associated with the creative.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
@@ -129,18 +132,19 @@ <h3>Method Details</h3>
         "A String",
       ],
       "accountId": 42, # Account id.
-      "videoURL": "A String", # The url to fetch a video ad. If set, HTMLSnippet should not be set.
+      "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is diffrent from resource.native_ad.video_url above.
       "clickThroughUrl": [ # The set of destination urls for the snippet.
         "A String",
       ],
       "languages": [ # Detected languages for this creative. Read-only. This field should not be set in requests.
         "A String",
       ],
       "width": 42, # Ad width.
-      "nativeAd": { # If nativeAd is set, HTMLSnippet and videoURL should not be set.
+      "nativeAd": { # If nativeAd is set, HTMLSnippet and the videoURL outside of nativeAd should not be set. (The videoURL inside nativeAd can be set.)
         "body": "A String", # A long description of the ad.
         "advertiser": "A String",
         "store": "A String", # The URL to the app store to purchase/download the promoted app.
+        "videoURL": "A String",
         "headline": "A String", # A short title for the ad.
         "image": { # A large image.
           "url": "A String",
@@ -271,18 +275,19 @@ <h3>Method Details</h3>
       "A String",
     ],
     "accountId": 42, # Account id.
-    "videoURL": "A String", # The url to fetch a video ad. If set, HTMLSnippet should not be set.
+    "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is diffrent from resource.native_ad.video_url above.
     "clickThroughUrl": [ # The set of destination urls for the snippet.
       "A String",
     ],
     "languages": [ # Detected languages for this creative. Read-only. This field should not be set in requests.
       "A String",
     ],
     "width": 42, # Ad width.
-    "nativeAd": { # If nativeAd is set, HTMLSnippet and videoURL should not be set.
+    "nativeAd": { # If nativeAd is set, HTMLSnippet and the videoURL outside of nativeAd should not be set. (The videoURL inside nativeAd can be set.)
       "body": "A String", # A long description of the ad.
       "advertiser": "A String",
       "store": "A String", # The URL to the app store to purchase/download the promoted app.
+      "videoURL": "A String",
       "headline": "A String", # A short title for the ad.
       "image": { # A large image.
         "url": "A String",
@@ -408,18 +413,19 @@ <h3>Method Details</h3>
         "A String",
       ],
       "accountId": 42, # Account id.
-      "videoURL": "A String", # The url to fetch a video ad. If set, HTMLSnippet should not be set.
+      "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is diffrent from resource.native_ad.video_url above.
       "clickThroughUrl": [ # The set of destination urls for the snippet.
         "A String",
       ],
       "languages": [ # Detected languages for this creative. Read-only. This field should not be set in requests.
         "A String",
       ],
       "width": 42, # Ad width.
-      "nativeAd": { # If nativeAd is set, HTMLSnippet and videoURL should not be set.
+      "nativeAd": { # If nativeAd is set, HTMLSnippet and the videoURL outside of nativeAd should not be set. (The videoURL inside nativeAd can be set.)
         "body": "A String", # A long description of the ad.
         "advertiser": "A String",
         "store": "A String", # The URL to the app store to purchase/download the promoted app.
+        "videoURL": "A String",
         "headline": "A String", # A short title for the ad.
         "image": { # A large image.
           "url": "A String",
@@ -570,18 +576,19 @@ <h3>Method Details</h3>
             "A String",
           ],
           "accountId": 42, # Account id.
-          "videoURL": "A String", # The url to fetch a video ad. If set, HTMLSnippet should not be set.
+          "videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is diffrent from resource.native_ad.video_url above.
           "clickThroughUrl": [ # The set of destination urls for the snippet.
             "A String",
           ],
           "languages": [ # Detected languages for this creative. Read-only. This field should not be set in requests.
             "A String",
           ],
           "width": 42, # Ad width.
-          "nativeAd": { # If nativeAd is set, HTMLSnippet and videoURL should not be set.
+          "nativeAd": { # If nativeAd is set, HTMLSnippet and the videoURL outside of nativeAd should not be set. (The videoURL inside nativeAd can be set.)
             "body": "A String", # A long description of the ad.
             "advertiser": "A String",
             "store": "A String", # The URL to the app store to purchase/download the promoted app.
+            "videoURL": "A String",
             "headline": "A String", # A short title for the ad.
             "image": { # A large image.
               "url": "A String",
@@ -693,6 +700,29 @@ <h3>Method Details</h3>
   }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="listDeals">listDeals(accountId, buyerCreativeId)</code>
+  <pre>Lists the external deal ids associated with the creative.
+
+Args:
+  accountId: integer, The id for the account that will serve this creative. (required)
+  buyerCreativeId: string, The buyer-specific id for this creative. (required)
+
+Returns:
+  An object of the form:
+
+    { # The external deal ids associated with a creative.
+    "dealStatuses": [ # A list of external deal ids and ARC approval status.
+      {
+        "webPropertyId": 42, # Publisher ID.
+        "dealId": "A String", # External deal ID.
+        "arcStatus": "A String", # ARC approval status.
+      },
+    ],
+    "kind": "adexchangebuyer#creativeDealIds", # Resource type.
+  }</pre>
+</div>
+
 <div class="method">
     <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
   <pre>Retrieves the next page of results.