-
Notifications
You must be signed in to change notification settings - Fork 19
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #72 from AdobeDocs/Prerelease
Prerelease rollout
- Loading branch information
Showing
10 changed files
with
74 additions
and
81 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -52,7 +52,7 @@ Here is a list of existing Fotolia API endpoints and their new Stock API equival | |
| [refreshToken](https://us.fotolia.com/Services/API/Rest/Method/refreshToken) | /ims/token (IMS) | Renew authentication token | See [Authentication](#authentication) | | ||
| [getUserData](https://us.fotolia.com/Services/API/Rest/Method/getUserData) | Member/Profile | Return information about the logged user and get available credits | To get license quota, use Member/Profile. Stock does not store information about the user, only about entitlements available | | ||
|
||
If you have a business requirement to access Stock Contributor APIs, please please [contact us](mailto:Grp-AdobeStockPartnerships@adobe.com?subject=%5BFotolia%5D%20Stock%20API%20question). | ||
Please note that [Adobe Stock Contributor](https://contributor.stock.adobe.com/) does not have a public API. | ||
|
||
<a id="search-filters-and-parameters"></a> | ||
|
||
|
@@ -94,7 +94,6 @@ Nearly all the Fotolia search parameters and filters are also available in Adobe | |
|
||
The following API endpoints and methods will be deprecated in Adobe Stock API as they are either not currently being used, no longer supported, or no longer necessary. These APIs either receive no traffic, or have such low usage that they are candidates for removal. | ||
|
||
If you have a business requirement for any of the APIs below, please [contact us](mailto:[email protected]?subject=%5BFotolia%5D%20Stock%20API%20question). | ||
|
||
| Fotolia | Adobe Stock | Description | | ||
|--------------------------------------|-------------|---------------------------------------------------------------------------| | ||
|
@@ -136,7 +135,7 @@ Unlike Fotolia, all Standard assets require one license or credit to purchase, r | |
|
||
> **Note for Print on Demand (POD) customers:** If you license assets for use with printed goods that you sell, there are special rules you must follow. For example, you must use universal credits instead of subscription plans when licensing. Also, you will need to license the asset again in most cases, especially if used for different customer orders or for multiple products. And lastly, you will need to accept special terms and conditions before you can begin selling Stock images on your printed goods. | ||
> | ||
> Note that if you purchase Extended licenses, these precautions are not necessary, but the cost per asset is much higher. To discuss your use case and expected volume, please [contact us](mailto:Grp-AdobeStockPartnerships@adobe.com?subject=%5BFotolia%5D%20Stock%20API%20question) for additional terms and instructions. | ||
> Note that if you purchase Extended licenses, these precautions are not necessary, but the cost per asset is much higher. To discuss your use case and expected volume, please contact your Adobe account representative or [request a callback](https://www.adobe.com/creativecloud/business/enterprise.html#creativecloud-rfi) for additional terms and instructions. | ||
In terms of technical workflow, continue reading for an overview. Please refer to [Licensing assets and stuff](/getting-started/apps/06-licensing-assets.md) for full details. | ||
|
||
|
@@ -183,15 +182,15 @@ You may start testing the Search APIs at any time; all that is required is a fre | |
|
||
### Get a Stock account | ||
|
||
If you are an individual customer, go to the [Plans and Pricing](https://stock.adobe.com/plans) page to sign up for an account. Note that if you plan to sell images for print use (e.g., you have a Print on Demand business), you will need to [contact us](mailto:Grp-AdobeStockPartnerships@adobe.com?subject=%5BFotolia%5D%20Stock%20API%20question) for additional terms and instructions, and to discuss your volume and use case. If you plan to use assets only for internal use (such as for general marketing and design), then you can choose your plan accordingly. | ||
If you are an individual customer, go to the [Plans and Pricing](https://stock.adobe.com/plans) page to sign up for an account. Note that if you plan to sell images for print use (e.g., you have a Print on Demand business), please contact your Adobe account representative or [request a callback](https://www.adobe.com/creativecloud/business/enterprise.html#creativecloud-rfi) to get a quote for a Stock for Enterprise contract. If you plan to use assets only for internal use (such as for general marketing and design), then you can choose your plan accordingly. | ||
|
||
If you do not need your own account but need to sign in others using the OAuth model, refer to the [Authorization code workflow](/Stock-Authorization-Code-Workflow.pdf) guide. If you have a business need, you may [contact us](mailto:[email protected]?subject=%5BFotolia%5D%20Stock%20API%20question) if you need access to a demo account with dummy credits to test licensing. | ||
If you do not need your own account but need to sign in others using the OAuth model, refer to the [Authorization code workflow](/Stock-Authorization-Code-Workflow.pdf) guide. | ||
|
||
<a id="sign-a-contract"></a> | ||
|
||
### Sign a contract | ||
|
||
As discussed earlier, if you plan to use Adobe Stock for commercial purposes--especially for selling printed goods--you will need to [contact us](mailto:Grp-AdobeStockPartnerships@adobe.com?subject=%5BFotolia%5D%20Stock%20API%20question). In many cases, you may need only accept our terms and conditions, and will be ready to begin. | ||
As discussed earlier, if you plan to use Adobe Stock for commercial purposes--especially for selling printed goods--please contact your Adobe account representative or [request a callback](https://www.adobe.com/creativecloud/business/enterprise.html#creativecloud-rfi). | ||
|
||
<a id="build-an-app"></a> | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -11,34 +11,31 @@ title: Stock API FAQs and supplemental info | |
description: Stock API Frequently Asked Questions. | ||
--- | ||
<!-- omit in toc --> | ||
|
||
# Stock API: Technical frequently asked questions | ||
|
||
A list of technical frequently asked questions. Don't see your question answered here? Email us at [email protected]. If you are looking for the Stock API Business FAQ, it is [located here](/faq/stock-api-business-faq.md). | ||
- [Stock API: Technical frequently asked questions](#stock-api-technical-frequently-asked-questions) | ||
- [General](#general) | ||
- [What thumbnail preview sizes are available?](#what-thumbnail-preview-sizes-are-available) | ||
- [Why don't all assets show up in Search API results?](#why-dont-all-assets-show-up-in-search-api-results) | ||
- [Why am I getting 429 errors from the API?](#why-am-i-getting-429-errors-from-the-api) | ||
- [Why are there more search results returned than the 'limit' value?](#why-are-there-more-search-results-returned-than-the-limit-value) | ||
- [Downloading](#downloading) | ||
- [How do I download a comp image?](#how-do-i-download-a-comp-image) | ||
- [How do I bulk download all of my license history?](#how-do-i-bulk-download-all-of-my-license-history) | ||
- [Why can't I download an asset from license history?](#why-cant-i-download-an-asset-from-license-history) | ||
- [For vector assets, can I request a JPEG or PNG version instead of AI or SVG?](#for-vector-assets-can-i-request-a-jpeg-or-png-version-instead-of-ai-or-svg) | ||
- [Enterprise](#enterprise) | ||
- [Why can’t I create a JWT Service Account for my CC Pro subscription?](#why-cant-i-create-a-jwt-service-account-for-my-cc-pro-subscription) | ||
- [How can I detect assets from the CC Pro plan in my license history?](#how-can-i-detect-assets-from-the-cc-pro-plan-in-my-license-history) | ||
- [How do I add license references?](#how-do-i-add-license-references) | ||
- [Why do I get an error when sending the JWT?](#why-do-i-get-an-error-when-sending-the-jwt) | ||
- [Print on Demand (POD)](#print-on-demand-pod) | ||
- [How do you license assets more than once?](#how-do-you-license-assets-more-than-once) | ||
- [Why do I see Premium and Video in my search results if I don't have credits?](#why-do-i-see-premium-and-video-in-my-search-results-if-i-dont-have-credits) | ||
- [How do I filter out Premium content?](#how-do-i-filter-out-premium-content) | ||
- [How do I filter for high-resolution images only?](#how-do-i-filter-for-high-resolution-images-only) | ||
- [How do I check if the images I am selling are still available on Stock?](#how-do-i-check-if-the-images-i-am-selling-are-still-available-on-stock) | ||
- [How do I filter out Free content?](#how-do-i-filter-out-free-content) | ||
- [Filtering free assets with the Files API](#filtering-free-assets-with-the-files-api) | ||
- [General](#general) | ||
- [What thumbnail preview sizes are available?](#what-thumbnail-preview-sizes-are-available) | ||
- [Why don't all assets show up in Search API results?](#why-dont-all-assets-show-up-in-search-api-results) | ||
- [Why am I getting 429 errors from the API?](#why-am-i-getting-429-errors-from-the-api) | ||
- [Why are there more search results returned than the 'limit' value?](#why-are-there-more-search-results-returned-than-the-limit-value) | ||
- [Downloading](#downloading) | ||
- [How do I download a comp image?](#how-do-i-download-a-comp-image) | ||
- [How do I bulk download all of my license history?](#how-do-i-bulk-download-all-of-my-license-history) | ||
- [Why can't I download an asset from license history?](#why-cant-i-download-an-asset-from-license-history) | ||
- [For vector assets, can I request a JPEG or PNG version instead of AI or SVG?](#for-vector-assets-can-i-request-a-jpeg-or-png-version-instead-of-ai-or-svg) | ||
- [Enterprise](#enterprise) | ||
- [Why can’t I create a JWT Service Account for my CC Pro subscription?](#why-cant-i-create-a-jwt-service-account-for-my-cc-pro-subscription) | ||
- [How can I detect assets from the CC Pro plan in my license history?](#how-can-i-detect-assets-from-the-cc-pro-plan-in-my-license-history) | ||
- [How do I add license references?](#how-do-i-add-license-references) | ||
- [Why do I get an error when sending the JWT?](#why-do-i-get-an-error-when-sending-the-jwt) | ||
- [Print on Demand (POD)](#print-on-demand-pod) | ||
- [How do you license assets more than once?](#how-do-you-license-assets-more-than-once) | ||
- [Why do I see Premium and Video in my search results if I don't have credits?](#why-do-i-see-premium-and-video-in-my-search-results-if-i-dont-have-credits) | ||
- [How do I filter out Premium content?](#how-do-i-filter-out-premium-content) | ||
- [How do I filter for high-resolution images only?](#how-do-i-filter-for-high-resolution-images-only) | ||
- [How do I check if the images I am selling are still available on Stock?](#how-do-i-check-if-the-images-i-am-selling-are-still-available-on-stock) | ||
- [How do I filter out Free content?](#how-do-i-filter-out-free-content) | ||
|
||
<a id="general"></a> | ||
|
||
|
@@ -532,6 +529,7 @@ Please also note that the Free collection can change. An image which is availabl | |
|
||
1. POD customers who do *offline* curation of Stock assets must use other methods to filter out free assets. For example, any images that are hand curated and saved in the customers database should be reviewed periodically for free content using the [**Files API**](/api/19-bulk-metadata-files-reference.md). | ||
|
||
<!-- omit from toc --> | ||
#### Filtering free assets with the Files API | ||
|
||
Free assets can be identified by their metadata, specifically by the `premium_level_id` field. **A value of '1' indicates a Free asset.** | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.