• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<html><body>
2<style>
3
4body, 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
15body {
16  font-size: 13px;
17  padding: 1em;
18}
19
20h1 {
21  font-size: 26px;
22  margin-bottom: 1em;
23}
24
25h2 {
26  font-size: 24px;
27  margin-bottom: 1em;
28}
29
30h3 {
31  font-size: 20px;
32  margin-bottom: 1em;
33  margin-top: 1em;
34}
35
36pre, code {
37  line-height: 1.5;
38  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42  margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46  font-family: Arial, sans serif;
47}
48
49h1, 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="apigee_v1.html">Apigee API</a> . <a href="apigee_v1.organizations.html">organizations</a> . <a href="apigee_v1.organizations.developers.html">developers</a> . <a href="apigee_v1.organizations.developers.apps.html">apps</a> . <a href="apigee_v1.organizations.developers.apps.keys.html">keys</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78  <code><a href="apigee_v1.organizations.developers.apps.keys.apiproducts.html">apiproducts()</a></code>
79</p>
80<p class="firstline">Returns the apiproducts Resource.</p>
81
82<p class="toc_element">
83  <code><a href="apigee_v1.organizations.developers.apps.keys.create.html">create()</a></code>
84</p>
85<p class="firstline">Returns the create 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="#delete">delete(name, x__xgafv=None)</a></code></p>
92<p class="firstline">Deletes an app's consumer key and removes all API products associated with the app. After the consumer key is deleted, it cannot be used to access any APIs. **Note**: After you delete a consumer key, you may want to: 1. Create a new consumer key and secret for the developer app using the CreateDeveloperAppKey API, and subsequently add an API product to the key using the UpdateDeveloperAppKey API. 2. Delete the developer app, if it is no longer required.</p>
93<p class="toc_element">
94  <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
95<p class="firstline">Gets details for a consumer key for a developer app, including the key and secret value, associated API products, and other information.</p>
96<p class="toc_element">
97  <code><a href="#replaceDeveloperAppKey">replaceDeveloperAppKey(name, body=None, x__xgafv=None)</a></code></p>
98<p class="firstline">Updates the scope of an app. This API replaces the existing scopes with those specified in the request. Include or exclude any existing scopes that you want to retain or delete, respectively. The specified scopes must already be defined for the API products associated with the app. This API sets the `scopes` element under the `apiProducts` element in the attributes of the app.</p>
99<p class="toc_element">
100  <code><a href="#updateDeveloperAppKey">updateDeveloperAppKey(name, action=None, body=None, x__xgafv=None)</a></code></p>
101<p class="firstline">Adds an API product to a developer app key, enabling the app that holds the key to access the API resources bundled in the API product. In addition, you can add attributes to a developer app key. This API replaces the existing attributes with those specified in the request. Include or exclude any existing attributes that you want to retain or delete, respectively. You can use the same key to access all API products associated with the app.</p>
102<h3>Method Details</h3>
103<div class="method">
104    <code class="details" id="close">close()</code>
105  <pre>Close httplib2 connections.</pre>
106</div>
107
108<div class="method">
109    <code class="details" id="delete">delete(name, x__xgafv=None)</code>
110  <pre>Deletes an app&#x27;s consumer key and removes all API products associated with the app. After the consumer key is deleted, it cannot be used to access any APIs. **Note**: After you delete a consumer key, you may want to: 1. Create a new consumer key and secret for the developer app using the CreateDeveloperAppKey API, and subsequently add an API product to the key using the UpdateDeveloperAppKey API. 2. Delete the developer app, if it is no longer required.
111
112Args:
113  name: string, Name of the developer app key. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}/keys/{key}` (required)
114  x__xgafv: string, V1 error format.
115    Allowed values
116      1 - v1 error format
117      2 - v2 error format
118
119Returns:
120  An object of the form:
121
122    {
123  &quot;apiProducts&quot;: [ # List of API products for which the credential can be used. **Note**: Do not specify the list of API products when creating a consumer key and secret for a developer app. Instead, use the UpdateDeveloperAppKey API to make the association after the consumer key and secret are created.
124    &quot;&quot;,
125  ],
126  &quot;attributes&quot;: [ # List of attributes associated with the credential.
127    { # Key-value pair to store extra metadata.
128      &quot;name&quot;: &quot;A String&quot;, # API key of the attribute.
129      &quot;value&quot;: &quot;A String&quot;, # Value of the attribute.
130    },
131  ],
132  &quot;consumerKey&quot;: &quot;A String&quot;, # Consumer key.
133  &quot;consumerSecret&quot;: &quot;A String&quot;, # Secret key.
134  &quot;expiresAt&quot;: &quot;A String&quot;, # Time the developer app expires in milliseconds since epoch.
135  &quot;expiresInSeconds&quot;: &quot;A String&quot;, # Input only. Expiration time, in seconds, for the consumer key. If not set or left to the default value of `-1`, the API key never expires. The expiration time can&#x27;t be updated after it is set.
136  &quot;issuedAt&quot;: &quot;A String&quot;, # Time the developer app was created in milliseconds since epoch.
137  &quot;scopes&quot;: [ # Scopes to apply to the app. The specified scope names must already be defined for the API product that you associate with the app.
138    &quot;A String&quot;,
139  ],
140  &quot;status&quot;: &quot;A String&quot;, # Status of the credential. Valid values include `approved` or `revoked`.
141}</pre>
142</div>
143
144<div class="method">
145    <code class="details" id="get">get(name, x__xgafv=None)</code>
146  <pre>Gets details for a consumer key for a developer app, including the key and secret value, associated API products, and other information.
147
148Args:
149  name: string, Name of the developer app key. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}/keys/{key}` (required)
150  x__xgafv: string, V1 error format.
151    Allowed values
152      1 - v1 error format
153      2 - v2 error format
154
155Returns:
156  An object of the form:
157
158    {
159  &quot;apiProducts&quot;: [ # List of API products for which the credential can be used. **Note**: Do not specify the list of API products when creating a consumer key and secret for a developer app. Instead, use the UpdateDeveloperAppKey API to make the association after the consumer key and secret are created.
160    &quot;&quot;,
161  ],
162  &quot;attributes&quot;: [ # List of attributes associated with the credential.
163    { # Key-value pair to store extra metadata.
164      &quot;name&quot;: &quot;A String&quot;, # API key of the attribute.
165      &quot;value&quot;: &quot;A String&quot;, # Value of the attribute.
166    },
167  ],
168  &quot;consumerKey&quot;: &quot;A String&quot;, # Consumer key.
169  &quot;consumerSecret&quot;: &quot;A String&quot;, # Secret key.
170  &quot;expiresAt&quot;: &quot;A String&quot;, # Time the developer app expires in milliseconds since epoch.
171  &quot;expiresInSeconds&quot;: &quot;A String&quot;, # Input only. Expiration time, in seconds, for the consumer key. If not set or left to the default value of `-1`, the API key never expires. The expiration time can&#x27;t be updated after it is set.
172  &quot;issuedAt&quot;: &quot;A String&quot;, # Time the developer app was created in milliseconds since epoch.
173  &quot;scopes&quot;: [ # Scopes to apply to the app. The specified scope names must already be defined for the API product that you associate with the app.
174    &quot;A String&quot;,
175  ],
176  &quot;status&quot;: &quot;A String&quot;, # Status of the credential. Valid values include `approved` or `revoked`.
177}</pre>
178</div>
179
180<div class="method">
181    <code class="details" id="replaceDeveloperAppKey">replaceDeveloperAppKey(name, body=None, x__xgafv=None)</code>
182  <pre>Updates the scope of an app. This API replaces the existing scopes with those specified in the request. Include or exclude any existing scopes that you want to retain or delete, respectively. The specified scopes must already be defined for the API products associated with the app. This API sets the `scopes` element under the `apiProducts` element in the attributes of the app.
183
184Args:
185  name: string, Name of the developer app key. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}/keys/{key}` (required)
186  body: object, The request body.
187    The object takes the form of:
188
189{
190  &quot;apiProducts&quot;: [ # List of API products for which the credential can be used. **Note**: Do not specify the list of API products when creating a consumer key and secret for a developer app. Instead, use the UpdateDeveloperAppKey API to make the association after the consumer key and secret are created.
191    &quot;&quot;,
192  ],
193  &quot;attributes&quot;: [ # List of attributes associated with the credential.
194    { # Key-value pair to store extra metadata.
195      &quot;name&quot;: &quot;A String&quot;, # API key of the attribute.
196      &quot;value&quot;: &quot;A String&quot;, # Value of the attribute.
197    },
198  ],
199  &quot;consumerKey&quot;: &quot;A String&quot;, # Consumer key.
200  &quot;consumerSecret&quot;: &quot;A String&quot;, # Secret key.
201  &quot;expiresAt&quot;: &quot;A String&quot;, # Time the developer app expires in milliseconds since epoch.
202  &quot;expiresInSeconds&quot;: &quot;A String&quot;, # Input only. Expiration time, in seconds, for the consumer key. If not set or left to the default value of `-1`, the API key never expires. The expiration time can&#x27;t be updated after it is set.
203  &quot;issuedAt&quot;: &quot;A String&quot;, # Time the developer app was created in milliseconds since epoch.
204  &quot;scopes&quot;: [ # Scopes to apply to the app. The specified scope names must already be defined for the API product that you associate with the app.
205    &quot;A String&quot;,
206  ],
207  &quot;status&quot;: &quot;A String&quot;, # Status of the credential. Valid values include `approved` or `revoked`.
208}
209
210  x__xgafv: string, V1 error format.
211    Allowed values
212      1 - v1 error format
213      2 - v2 error format
214
215Returns:
216  An object of the form:
217
218    {
219  &quot;apiProducts&quot;: [ # List of API products for which the credential can be used. **Note**: Do not specify the list of API products when creating a consumer key and secret for a developer app. Instead, use the UpdateDeveloperAppKey API to make the association after the consumer key and secret are created.
220    &quot;&quot;,
221  ],
222  &quot;attributes&quot;: [ # List of attributes associated with the credential.
223    { # Key-value pair to store extra metadata.
224      &quot;name&quot;: &quot;A String&quot;, # API key of the attribute.
225      &quot;value&quot;: &quot;A String&quot;, # Value of the attribute.
226    },
227  ],
228  &quot;consumerKey&quot;: &quot;A String&quot;, # Consumer key.
229  &quot;consumerSecret&quot;: &quot;A String&quot;, # Secret key.
230  &quot;expiresAt&quot;: &quot;A String&quot;, # Time the developer app expires in milliseconds since epoch.
231  &quot;expiresInSeconds&quot;: &quot;A String&quot;, # Input only. Expiration time, in seconds, for the consumer key. If not set or left to the default value of `-1`, the API key never expires. The expiration time can&#x27;t be updated after it is set.
232  &quot;issuedAt&quot;: &quot;A String&quot;, # Time the developer app was created in milliseconds since epoch.
233  &quot;scopes&quot;: [ # Scopes to apply to the app. The specified scope names must already be defined for the API product that you associate with the app.
234    &quot;A String&quot;,
235  ],
236  &quot;status&quot;: &quot;A String&quot;, # Status of the credential. Valid values include `approved` or `revoked`.
237}</pre>
238</div>
239
240<div class="method">
241    <code class="details" id="updateDeveloperAppKey">updateDeveloperAppKey(name, action=None, body=None, x__xgafv=None)</code>
242  <pre>Adds an API product to a developer app key, enabling the app that holds the key to access the API resources bundled in the API product. In addition, you can add attributes to a developer app key. This API replaces the existing attributes with those specified in the request. Include or exclude any existing attributes that you want to retain or delete, respectively. You can use the same key to access all API products associated with the app.
243
244Args:
245  name: string, Name of the developer app key. Use the following structure in your request: `organizations/{org}/developers/{developer_email}/apps/{app}/keys/{key}` (required)
246  body: object, The request body.
247    The object takes the form of:
248
249{
250  &quot;apiProducts&quot;: [ # List of API products for which the credential can be used. **Note**: Do not specify the list of API products when creating a consumer key and secret for a developer app. Instead, use the UpdateDeveloperAppKey API to make the association after the consumer key and secret are created.
251    &quot;&quot;,
252  ],
253  &quot;attributes&quot;: [ # List of attributes associated with the credential.
254    { # Key-value pair to store extra metadata.
255      &quot;name&quot;: &quot;A String&quot;, # API key of the attribute.
256      &quot;value&quot;: &quot;A String&quot;, # Value of the attribute.
257    },
258  ],
259  &quot;consumerKey&quot;: &quot;A String&quot;, # Consumer key.
260  &quot;consumerSecret&quot;: &quot;A String&quot;, # Secret key.
261  &quot;expiresAt&quot;: &quot;A String&quot;, # Time the developer app expires in milliseconds since epoch.
262  &quot;expiresInSeconds&quot;: &quot;A String&quot;, # Input only. Expiration time, in seconds, for the consumer key. If not set or left to the default value of `-1`, the API key never expires. The expiration time can&#x27;t be updated after it is set.
263  &quot;issuedAt&quot;: &quot;A String&quot;, # Time the developer app was created in milliseconds since epoch.
264  &quot;scopes&quot;: [ # Scopes to apply to the app. The specified scope names must already be defined for the API product that you associate with the app.
265    &quot;A String&quot;,
266  ],
267  &quot;status&quot;: &quot;A String&quot;, # Status of the credential. Valid values include `approved` or `revoked`.
268}
269
270  action: string, Approve or revoke the consumer key by setting this value to `approve` or `revoke`, respectively.
271  x__xgafv: string, V1 error format.
272    Allowed values
273      1 - v1 error format
274      2 - v2 error format
275
276Returns:
277  An object of the form:
278
279    {
280  &quot;apiProducts&quot;: [ # List of API products for which the credential can be used. **Note**: Do not specify the list of API products when creating a consumer key and secret for a developer app. Instead, use the UpdateDeveloperAppKey API to make the association after the consumer key and secret are created.
281    &quot;&quot;,
282  ],
283  &quot;attributes&quot;: [ # List of attributes associated with the credential.
284    { # Key-value pair to store extra metadata.
285      &quot;name&quot;: &quot;A String&quot;, # API key of the attribute.
286      &quot;value&quot;: &quot;A String&quot;, # Value of the attribute.
287    },
288  ],
289  &quot;consumerKey&quot;: &quot;A String&quot;, # Consumer key.
290  &quot;consumerSecret&quot;: &quot;A String&quot;, # Secret key.
291  &quot;expiresAt&quot;: &quot;A String&quot;, # Time the developer app expires in milliseconds since epoch.
292  &quot;expiresInSeconds&quot;: &quot;A String&quot;, # Input only. Expiration time, in seconds, for the consumer key. If not set or left to the default value of `-1`, the API key never expires. The expiration time can&#x27;t be updated after it is set.
293  &quot;issuedAt&quot;: &quot;A String&quot;, # Time the developer app was created in milliseconds since epoch.
294  &quot;scopes&quot;: [ # Scopes to apply to the app. The specified scope names must already be defined for the API product that you associate with the app.
295    &quot;A String&quot;,
296  ],
297  &quot;status&quot;: &quot;A String&quot;, # Status of the credential. Valid values include `approved` or `revoked`.
298}</pre>
299</div>
300
301</body></html>