Debian Codegraph @

docs/dyn/displayvideo_v3.customBiddingAlgorithms.html

raw
1 <html><body>
2 <style>
3
4 body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13 }
14
15 body {
16 font-size: 13px;
17 padding: 1em;
18 }
19
20 h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23 }
24
25 h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28 }
29
30 h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34 }
35
36 pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39 }
40
41 pre {
42 margin-top: 0.5em;
43 }
44
45 h1, h2, h3, p {
46 font-family: Arial, sans serif;
47 }
48
49 h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51 }
52
53 .toc_element {
54 margin-top: 0.5em;
55 }
56
57 .firstline {
58 margin-left: 2 em;
59 }
60
61 .method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66 }
67
68 .details {
69 font-weight: bold;
70 font-size: 14px;
71 }
72
73 </style>
74
75 <h1><a href="displayvideo_v3.html">Display & Video 360 API</a> . <a href="displayvideo_v3.customBiddingAlgorithms.html">customBiddingAlgorithms</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="displayvideo_v3.customBiddingAlgorithms.rules.html">rules()</a></code>
79 </p>
80 <p class="firstline">Returns the rules Resource.</p>
81
82 <p class="toc_element">
83 <code><a href="displayvideo_v3.customBiddingAlgorithms.scripts.html">scripts()</a></code>
84 </p>
85 <p class="firstline">Returns the scripts Resource.</p>
86
87 <p class="toc_element">
88 <code><a href="#close">close()</a></code></p>
89 <p class="firstline">Close httplib2 connections.</p>
90 <p class="toc_element">
91 <code><a href="#create">create(body=None, x__xgafv=None)</a></code></p>
92 <p class="firstline">Creates a new custom bidding algorithm. Returns the newly created custom bidding algorithm if successful.</p>
93 <p class="toc_element">
94 <code><a href="#get">get(customBiddingAlgorithmId, advertiserId=None, partnerId=None, x__xgafv=None)</a></code></p>
95 <p class="firstline">Gets a custom bidding algorithm.</p>
96 <p class="toc_element">
97 <code><a href="#list">list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)</a></code></p>
98 <p class="firstline">Lists custom bidding algorithms that are accessible to the current user and can be used in bidding stratgies. The order is defined by the order_by parameter.</p>
99 <p class="toc_element">
100 <code><a href="#list_next">list_next()</a></code></p>
101 <p class="firstline">Retrieves the next page of results.</p>
102 <p class="toc_element">
103 <code><a href="#patch">patch(customBiddingAlgorithmId, body=None, updateMask=None, x__xgafv=None)</a></code></p>
104 <p class="firstline">Updates an existing custom bidding algorithm. Returns the updated custom bidding algorithm if successful. Requests updating a custom bidding algorithm assigned to a line item will return an error.</p>
105 <p class="toc_element">
106 <code><a href="#uploadRules">uploadRules(customBiddingAlgorithmId, advertiserId=None, partnerId=None, x__xgafv=None)</a></code></p>
107 <p class="firstline">Creates a rules reference object for an AlgorithmRules file. The resulting reference object provides a resource path where the AlgorithmRules file should be uploaded. This reference object should be included when creating a new CustomBiddingAlgorithmRules resource.</p>
108 <p class="toc_element">
109 <code><a href="#uploadScript">uploadScript(customBiddingAlgorithmId, advertiserId=None, partnerId=None, x__xgafv=None)</a></code></p>
110 <p class="firstline">Creates a custom bidding script reference object for a script file. The resulting reference object provides a resource path to which the script file should be uploaded. This reference object should be included in when creating a new custom bidding script object.</p>
111 <h3>Method Details</h3>
112 <div class="method">
113 <code class="details" id="close">close()</code>
114 <pre>Close httplib2 connections.</pre>
115 </div>
116
117 <div class="method">
118 <code class="details" id="create">create(body=None, x__xgafv=None)</code>
119 <pre>Creates a new custom bidding algorithm. Returns the newly created custom bidding algorithm if successful.
120
121 Args:
122 body: object, The request body.
123 The object takes the form of:
124
125 { # A single custom bidding algorithm.
126 &quot;advertiserId&quot;: &quot;A String&quot;, # Immutable. The unique ID of the advertiser that owns the custom bidding algorithm.
127 &quot;customBiddingAlgorithmId&quot;: &quot;A String&quot;, # Output only. The unique ID of the custom bidding algorithm. Assigned by the system.
128 &quot;customBiddingAlgorithmType&quot;: &quot;A String&quot;, # Required. Immutable. The type of custom bidding algorithm.
129 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the custom bidding algorithm. Must be UTF-8 encoded with a maximum size of 240 bytes.
130 &quot;entityStatus&quot;: &quot;A String&quot;, # Controls whether or not the custom bidding algorithm can be used as a bidding strategy. Accepted values are: * `ENTITY_STATUS_ACTIVE` * `ENTITY_STATUS_ARCHIVED`
131 &quot;modelDetails&quot;: [ # Output only. The details of custom bidding models for each advertiser who has access. This field may only include the details of the queried advertiser if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor).
132 { # The details of a custom bidding algorithm model for a single shared advertiser.
133 &quot;advertiserId&quot;: &quot;A String&quot;, # The unique ID of the relevant advertiser.
134 &quot;readinessState&quot;: &quot;A String&quot;, # The readiness state of custom bidding model.
135 &quot;suspensionState&quot;: &quot;A String&quot;, # Output only. The suspension state of custom bidding model.
136 },
137 ],
138 &quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the custom bidding algorithm.
139 &quot;partnerId&quot;: &quot;A String&quot;, # Immutable. The unique ID of the partner that owns the custom bidding algorithm.
140 &quot;sharedAdvertiserIds&quot;: [ # The IDs of the advertisers who have access to this algorithm. If advertiser_id is set, this field will only consist of that value. This field will not be set if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor).
141 &quot;A String&quot;,
142 ],
143 }
144
145 x__xgafv: string, V1 error format.
146 Allowed values
147 1 - v1 error format
148 2 - v2 error format
149
150 Returns:
151 An object of the form:
152
153 { # A single custom bidding algorithm.
154 &quot;advertiserId&quot;: &quot;A String&quot;, # Immutable. The unique ID of the advertiser that owns the custom bidding algorithm.
155 &quot;customBiddingAlgorithmId&quot;: &quot;A String&quot;, # Output only. The unique ID of the custom bidding algorithm. Assigned by the system.
156 &quot;customBiddingAlgorithmType&quot;: &quot;A String&quot;, # Required. Immutable. The type of custom bidding algorithm.
157 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the custom bidding algorithm. Must be UTF-8 encoded with a maximum size of 240 bytes.
158 &quot;entityStatus&quot;: &quot;A String&quot;, # Controls whether or not the custom bidding algorithm can be used as a bidding strategy. Accepted values are: * `ENTITY_STATUS_ACTIVE` * `ENTITY_STATUS_ARCHIVED`
159 &quot;modelDetails&quot;: [ # Output only. The details of custom bidding models for each advertiser who has access. This field may only include the details of the queried advertiser if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor).
160 { # The details of a custom bidding algorithm model for a single shared advertiser.
161 &quot;advertiserId&quot;: &quot;A String&quot;, # The unique ID of the relevant advertiser.
162 &quot;readinessState&quot;: &quot;A String&quot;, # The readiness state of custom bidding model.
163 &quot;suspensionState&quot;: &quot;A String&quot;, # Output only. The suspension state of custom bidding model.
164 },
165 ],
166 &quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the custom bidding algorithm.
167 &quot;partnerId&quot;: &quot;A String&quot;, # Immutable. The unique ID of the partner that owns the custom bidding algorithm.
168 &quot;sharedAdvertiserIds&quot;: [ # The IDs of the advertisers who have access to this algorithm. If advertiser_id is set, this field will only consist of that value. This field will not be set if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor).
169 &quot;A String&quot;,
170 ],
171 }</pre>
172 </div>
173
174 <div class="method">
175 <code class="details" id="get">get(customBiddingAlgorithmId, advertiserId=None, partnerId=None, x__xgafv=None)</code>
176 <pre>Gets a custom bidding algorithm.
177
178 Args:
179 customBiddingAlgorithmId: string, Required. The ID of the custom bidding algorithm to fetch. (required)
180 advertiserId: string, The ID of the DV360 partner that has access to the custom bidding algorithm.
181 partnerId: string, The ID of the DV360 partner that has access to the custom bidding algorithm.
182 x__xgafv: string, V1 error format.
183 Allowed values
184 1 - v1 error format
185 2 - v2 error format
186
187 Returns:
188 An object of the form:
189
190 { # A single custom bidding algorithm.
191 &quot;advertiserId&quot;: &quot;A String&quot;, # Immutable. The unique ID of the advertiser that owns the custom bidding algorithm.
192 &quot;customBiddingAlgorithmId&quot;: &quot;A String&quot;, # Output only. The unique ID of the custom bidding algorithm. Assigned by the system.
193 &quot;customBiddingAlgorithmType&quot;: &quot;A String&quot;, # Required. Immutable. The type of custom bidding algorithm.
194 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the custom bidding algorithm. Must be UTF-8 encoded with a maximum size of 240 bytes.
195 &quot;entityStatus&quot;: &quot;A String&quot;, # Controls whether or not the custom bidding algorithm can be used as a bidding strategy. Accepted values are: * `ENTITY_STATUS_ACTIVE` * `ENTITY_STATUS_ARCHIVED`
196 &quot;modelDetails&quot;: [ # Output only. The details of custom bidding models for each advertiser who has access. This field may only include the details of the queried advertiser if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor).
197 { # The details of a custom bidding algorithm model for a single shared advertiser.
198 &quot;advertiserId&quot;: &quot;A String&quot;, # The unique ID of the relevant advertiser.
199 &quot;readinessState&quot;: &quot;A String&quot;, # The readiness state of custom bidding model.
200 &quot;suspensionState&quot;: &quot;A String&quot;, # Output only. The suspension state of custom bidding model.
201 },
202 ],
203 &quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the custom bidding algorithm.
204 &quot;partnerId&quot;: &quot;A String&quot;, # Immutable. The unique ID of the partner that owns the custom bidding algorithm.
205 &quot;sharedAdvertiserIds&quot;: [ # The IDs of the advertisers who have access to this algorithm. If advertiser_id is set, this field will only consist of that value. This field will not be set if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor).
206 &quot;A String&quot;,
207 ],
208 }</pre>
209 </div>
210
211 <div class="method">
212 <code class="details" id="list">list(advertiserId=None, filter=None, orderBy=None, pageSize=None, pageToken=None, partnerId=None, x__xgafv=None)</code>
213 <pre>Lists custom bidding algorithms that are accessible to the current user and can be used in bidding stratgies. The order is defined by the order_by parameter.
214
215 Args:
216 advertiserId: string, The ID of the DV360 advertiser that has access to the custom bidding algorithm.
217 filter: string, Allows filtering by custom bidding algorithm fields. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions can be combined by `AND`. A sequence of restrictions implicitly uses `AND`. * A restriction has the form of `{field} {operator} {value}`. * The `customBiddingAlgorithmType` field must use the `EQUALS (=)` operator. * The `displayName` field must use the `HAS (:)` operator. Supported fields: * `customBiddingAlgorithmType` * `displayName` Examples: * All custom bidding algorithms for which the display name contains &quot;politics&quot;: `displayName:&quot;politics&quot;`. * All custom bidding algorithms for which the type is &quot;SCRIPT_BASED&quot;: `customBiddingAlgorithmType=SCRIPT_BASED` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information.
218 orderBy: string, Field by which to sort the list. Acceptable values are: * `displayName` (default) The default sorting order is ascending. To specify descending order for a field, a suffix &quot;desc&quot; should be added to the field name. Example: `displayName desc`.
219 pageSize: integer, Requested page size. Must be between `1` and `200`. If unspecified will default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified.
220 pageToken: string, A token identifying a page of results the server should return. Typically, this is the value of next_page_token returned from the previous call to `ListCustomBiddingAlgorithms` method. If not specified, the first page of results will be returned.
221 partnerId: string, The ID of the DV360 partner that has access to the custom bidding algorithm.
222 x__xgafv: string, V1 error format.
223 Allowed values
224 1 - v1 error format
225 2 - v2 error format
226
227 Returns:
228 An object of the form:
229
230 {
231 &quot;customBiddingAlgorithms&quot;: [ # The list of custom bidding algorithms. This list will be absent if empty.
232 { # A single custom bidding algorithm.
233 &quot;advertiserId&quot;: &quot;A String&quot;, # Immutable. The unique ID of the advertiser that owns the custom bidding algorithm.
234 &quot;customBiddingAlgorithmId&quot;: &quot;A String&quot;, # Output only. The unique ID of the custom bidding algorithm. Assigned by the system.
235 &quot;customBiddingAlgorithmType&quot;: &quot;A String&quot;, # Required. Immutable. The type of custom bidding algorithm.
236 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the custom bidding algorithm. Must be UTF-8 encoded with a maximum size of 240 bytes.
237 &quot;entityStatus&quot;: &quot;A String&quot;, # Controls whether or not the custom bidding algorithm can be used as a bidding strategy. Accepted values are: * `ENTITY_STATUS_ACTIVE` * `ENTITY_STATUS_ARCHIVED`
238 &quot;modelDetails&quot;: [ # Output only. The details of custom bidding models for each advertiser who has access. This field may only include the details of the queried advertiser if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor).
239 { # The details of a custom bidding algorithm model for a single shared advertiser.
240 &quot;advertiserId&quot;: &quot;A String&quot;, # The unique ID of the relevant advertiser.
241 &quot;readinessState&quot;: &quot;A String&quot;, # The readiness state of custom bidding model.
242 &quot;suspensionState&quot;: &quot;A String&quot;, # Output only. The suspension state of custom bidding model.
243 },
244 ],
245 &quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the custom bidding algorithm.
246 &quot;partnerId&quot;: &quot;A String&quot;, # Immutable. The unique ID of the partner that owns the custom bidding algorithm.
247 &quot;sharedAdvertiserIds&quot;: [ # The IDs of the advertisers who have access to this algorithm. If advertiser_id is set, this field will only consist of that value. This field will not be set if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor).
248 &quot;A String&quot;,
249 ],
250 },
251 ],
252 &quot;nextPageToken&quot;: &quot;A String&quot;, # A token to retrieve the next page of results. Pass this value in the page_token field in the subsequent call to `ListCustomBiddingAlgorithmsRequest` method to retrieve the next page of results. If this field is null, it means this is the last page.
253 }</pre>
254 </div>
255
256 <div class="method">
257 <code class="details" id="list_next">list_next()</code>
258 <pre>Retrieves the next page of results.
259
260 Args:
261 previous_request: The request for the previous page. (required)
262 previous_response: The response from the request for the previous page. (required)
263
264 Returns:
265 A request object that you can call &#x27;execute()&#x27; on to request the next
266 page. Returns None if there are no more items in the collection.
267 </pre>
268 </div>
269
270 <div class="method">
271 <code class="details" id="patch">patch(customBiddingAlgorithmId, body=None, updateMask=None, x__xgafv=None)</code>
272 <pre>Updates an existing custom bidding algorithm. Returns the updated custom bidding algorithm if successful. Requests updating a custom bidding algorithm assigned to a line item will return an error.
273
274 Args:
275 customBiddingAlgorithmId: string, Output only. The unique ID of the custom bidding algorithm. Assigned by the system. (required)
276 body: object, The request body.
277 The object takes the form of:
278
279 { # A single custom bidding algorithm.
280 &quot;advertiserId&quot;: &quot;A String&quot;, # Immutable. The unique ID of the advertiser that owns the custom bidding algorithm.
281 &quot;customBiddingAlgorithmId&quot;: &quot;A String&quot;, # Output only. The unique ID of the custom bidding algorithm. Assigned by the system.
282 &quot;customBiddingAlgorithmType&quot;: &quot;A String&quot;, # Required. Immutable. The type of custom bidding algorithm.
283 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the custom bidding algorithm. Must be UTF-8 encoded with a maximum size of 240 bytes.
284 &quot;entityStatus&quot;: &quot;A String&quot;, # Controls whether or not the custom bidding algorithm can be used as a bidding strategy. Accepted values are: * `ENTITY_STATUS_ACTIVE` * `ENTITY_STATUS_ARCHIVED`
285 &quot;modelDetails&quot;: [ # Output only. The details of custom bidding models for each advertiser who has access. This field may only include the details of the queried advertiser if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor).
286 { # The details of a custom bidding algorithm model for a single shared advertiser.
287 &quot;advertiserId&quot;: &quot;A String&quot;, # The unique ID of the relevant advertiser.
288 &quot;readinessState&quot;: &quot;A String&quot;, # The readiness state of custom bidding model.
289 &quot;suspensionState&quot;: &quot;A String&quot;, # Output only. The suspension state of custom bidding model.
290 },
291 ],
292 &quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the custom bidding algorithm.
293 &quot;partnerId&quot;: &quot;A String&quot;, # Immutable. The unique ID of the partner that owns the custom bidding algorithm.
294 &quot;sharedAdvertiserIds&quot;: [ # The IDs of the advertisers who have access to this algorithm. If advertiser_id is set, this field will only consist of that value. This field will not be set if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor).
295 &quot;A String&quot;,
296 ],
297 }
298
299 updateMask: string, Required. The mask to control which fields to update.
300 x__xgafv: string, V1 error format.
301 Allowed values
302 1 - v1 error format
303 2 - v2 error format
304
305 Returns:
306 An object of the form:
307
308 { # A single custom bidding algorithm.
309 &quot;advertiserId&quot;: &quot;A String&quot;, # Immutable. The unique ID of the advertiser that owns the custom bidding algorithm.
310 &quot;customBiddingAlgorithmId&quot;: &quot;A String&quot;, # Output only. The unique ID of the custom bidding algorithm. Assigned by the system.
311 &quot;customBiddingAlgorithmType&quot;: &quot;A String&quot;, # Required. Immutable. The type of custom bidding algorithm.
312 &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the custom bidding algorithm. Must be UTF-8 encoded with a maximum size of 240 bytes.
313 &quot;entityStatus&quot;: &quot;A String&quot;, # Controls whether or not the custom bidding algorithm can be used as a bidding strategy. Accepted values are: * `ENTITY_STATUS_ACTIVE` * `ENTITY_STATUS_ARCHIVED`
314 &quot;modelDetails&quot;: [ # Output only. The details of custom bidding models for each advertiser who has access. This field may only include the details of the queried advertiser if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor).
315 { # The details of a custom bidding algorithm model for a single shared advertiser.
316 &quot;advertiserId&quot;: &quot;A String&quot;, # The unique ID of the relevant advertiser.
317 &quot;readinessState&quot;: &quot;A String&quot;, # The readiness state of custom bidding model.
318 &quot;suspensionState&quot;: &quot;A String&quot;, # Output only. The suspension state of custom bidding model.
319 },
320 ],
321 &quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the custom bidding algorithm.
322 &quot;partnerId&quot;: &quot;A String&quot;, # Immutable. The unique ID of the partner that owns the custom bidding algorithm.
323 &quot;sharedAdvertiserIds&quot;: [ # The IDs of the advertisers who have access to this algorithm. If advertiser_id is set, this field will only consist of that value. This field will not be set if the algorithm [`owner`](/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.oneof_owner) is a partner and is being retrieved using an advertiser [`accessor`](/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.oneof_accessor).
324 &quot;A String&quot;,
325 ],
326 }</pre>
327 </div>
328
329 <div class="method">
330 <code class="details" id="uploadRules">uploadRules(customBiddingAlgorithmId, advertiserId=None, partnerId=None, x__xgafv=None)</code>
331 <pre>Creates a rules reference object for an AlgorithmRules file. The resulting reference object provides a resource path where the AlgorithmRules file should be uploaded. This reference object should be included when creating a new CustomBiddingAlgorithmRules resource.
332
333 Args:
334 customBiddingAlgorithmId: string, Required. The ID of the custom bidding algorithm that owns the rules resource. (required)
335 advertiserId: string, The ID of the advertiser that owns the parent custom bidding algorithm.
336 partnerId: string, The ID of the partner that owns the parent custom bidding algorithm.
337 x__xgafv: string, V1 error format.
338 Allowed values
339 1 - v1 error format
340 2 - v2 error format
341
342 Returns:
343 An object of the form:
344
345 { # The reference to the uploaded AlgorithmRules file. Retrieve the location to upload new AlgorithmRules file to using customBiddingAlgorithms.uploadRules.
346 &quot;resourceName&quot;: &quot;A String&quot;, # A resource name to be used in media.download to download the rules files. Or media.upload to upload the rules files. Resource names have the format `customBiddingAlgorithms/{custom_bidding_algorithm_id}/rulesRef/{ref_id}`.
347 }</pre>
348 </div>
349
350 <div class="method">
351 <code class="details" id="uploadScript">uploadScript(customBiddingAlgorithmId, advertiserId=None, partnerId=None, x__xgafv=None)</code>
352 <pre>Creates a custom bidding script reference object for a script file. The resulting reference object provides a resource path to which the script file should be uploaded. This reference object should be included in when creating a new custom bidding script object.
353
354 Args:
355 customBiddingAlgorithmId: string, Required. The ID of the custom bidding algorithm owns the script. (required)
356 advertiserId: string, The ID of the advertiser that owns the parent custom bidding algorithm.
357 partnerId: string, The ID of the partner that owns the parent custom bidding algorithm. Only this partner will have write access to this custom bidding script.
358 x__xgafv: string, V1 error format.
359 Allowed values
360 1 - v1 error format
361 2 - v2 error format
362
363 Returns:
364 An object of the form:
365
366 { # The reference to the uploaded custom bidding script file.
367 &quot;resourceName&quot;: &quot;A String&quot;, # A resource name to be used in media.download to Download the script files. Or media.upload to Upload the script files. Resource names have the format `customBiddingAlgorithms/{custom_bidding_algorithm_id}/scriptRef/{ref_id}`.
368 }</pre>
369 </div>
370
371 </body></html>