Skip to content

Commit

Permalink
Prerelease
Browse files Browse the repository at this point in the history
  • Loading branch information
chfabbro committed Nov 22, 2024
1 parent 0d0b397 commit 2dd8a2f
Show file tree
Hide file tree
Showing 5 changed files with 30 additions and 69 deletions.
1 change: 1 addition & 0 deletions src/pages/api/14-locale-codes.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,4 +89,5 @@ Several API methods allow the use of locale codes so that you can retrieve asset
| en_TT | English - Trinidad and Tobago |
| en_TM | English - Turkmenistan |
| es_UY | Spanish - Uruguay |
| zh_CN | Simplified Chinese - China |
| zh_MO | Chinese - Macao |
48 changes: 23 additions & 25 deletions src/pages/faq/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down Expand Up @@ -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.**
Expand Down
1 change: 0 additions & 1 deletion src/pages/faq/stock-api-business-faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,6 @@ description: Stock API Frequently Asked Questions.
A list of questions and answers for customers and partners looking to use Stock APIs, from a business perspective. For technical questions on the Stock APIs, see the [Technical FAQ](/faq/).

<!-- MarkdownTOC -->

- [General FAQ](#general-faq)
- [How can I contact Adobe Stock to discuss a business proposal or get technical assistance?](#how-can-i-contact-adobe-stock-to-discuss-a-business-proposal-or-get-technical-assistance)
- [How much does it cost to access Adobe Stock API?](#how-much-does-it-cost-to-access-adobe-stock-api)
Expand Down
40 changes: 2 additions & 38 deletions src/pages/faq/terms-for-adobe-stock-developers.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,42 +13,6 @@ description: Stock API Frequently Asked Questions.

# Terms for Adobe Stock Developers

By using the Adobe Stock Developer Tools (defined below), I acknowledge that I have read and agreed to these Terms for Adobe Stock Developers ("**Stock Developer Terms**"). These Stock Developer Terms incorporate by reference the Adobe Developer Additional Terms found at https://wwwimages2.adobe.com/content/dam/acom/en/legal/servicetou/Adobe-Developer-Additional-Terms_en_US_20180605_2200.pdf (or successor URL), and capitalized terms not defined here have the same meaning as defined in the Adobe Developer Additional Terms. These Stock Developer Terms are supplemental to, and will not replace or limit any other agreement you have with Adobe, except that in the event of any conflict between the Adobe Developer Additional Terms, these Stock Developer Terms will control with regard to Adobe Stock only. You are solely responsible and liable for the use of the Adobe Stock Developer Tools by your employer, employees, contractors, colleagues, and clients.
See http://www.adobe.com/go/developer-terms.

1. __Definitions.__

1.1. Adobe Stock Affiliate Partners participate in an affiliate, referral, or similar partner program for the promotion of Adobe Stock pursuant to a separate written agreement with Adobe. Subject to the Adobe Stock Affiliate Partner's agreement with Adobe, you may use the Adobe Stock SDKs and APIs solely for the purposes of promoting Adobe Stock.

1.2. Adobe Stock Developer Tools are the SDKs, APIs, portals, and other Adobe-offered developer resources for Adobe Stock.

1.3. Asset Management Services include Adobe Experience Manager and other third party solutions deployed by Adobe customers directly or via third party services that allow users to organize, select, and maintain records related to searched and/or licensed Adobe Stock Works, including systematically connecting licensed Adobe Stock Works to the customer's internal platforms (e.g., digital asset management and content management systems).

1.4. Marketing Platforms integrate Adobe Stock Works into workflows for your websites and ad builders, and for your email, content marketing, and social media platforms.

1.5. Print-on-Demand provides end users with the ability to use Adobe Stock Works to create customized printed materials intended for end users' advertising, marketing and promotional purposes; and units of tangible goods intended for sale to a single end user.

1.6. Third Party Software Integrations are digital products or services that utilize the Adobe Stock SDKs or APIs for the purpose of including access to Adobe Stock Works in custom applications.

2. __Login, Search, and License Services.__ If your Developer Software is for Asset Management Services, Print-on-Demand, Third-Party Software Integrations, or Marketing Platforms, you may use the Adobe Stock SDKs and APIs solely to enable Adobe customers: (A) to log in to the applicable Adobe Stock customer account through your Developer Software, provided that you must obtain express permission from the Adobe customer to access the applicable user's account; and (B) who are logged in to Adobe Stock through your Developer Software to search and license Adobe Stock Works pursuant to the customer's agreement with Adobe. Adobe may discontinue the licensing of any Adobe Stock Work and deny the downloading of any Adobe Stock Work at any time.

3. __Treatment of Adobe Stock Works.__

3.1. If you are granted access by Adobe to Adobe Stock Works, you may use them solely for the purposes of developing and deploying the Developer Software. You may not allow any Adobe Stock Work to be downloaded from your Developer Software as a standalone file, unless licensed to the end user by Adobe Stock. If your Developer Software is for Print-on-Demand, Third-Party Software Integrations, or Marketing Platforms, you may allow third parties to view watermarked or thumbnail versions of the Adobe Stock Works that have not been licensed.

3.2. You must ensure that: (A) Adobe Stock Works cannot be copied, distributed, altered or displayed other than as permitted by these Stock Developer Terms; (B) the contributors' names are visible on or adjacent to each Adobe Stock Work displayed in your Developer Software in the following format: "Contributor Name / Adobe Stock". You must not: (C) state or imply that any Adobe Stock Work is created or owned by you, or remove any watermarks, notices, metadata, or other information from the Adobe Stock Works; or (D) place or allow third parties to place: (1) materials near or next to the Adobe Stock Works if the material contains or displays adult content, promotes illegal activities or the sale of tobacco, or is otherwise defamatory, illegal, obscene, or indecent, including but not limited to pornography, escort services, or adult entertainment clubs, or similar venues; or (2) advertisements or other materials that obscure or alter the Adobe Stock Works or attribution to the Adobe Stock Works.

4. __Editorial Adobe Stock Works.__ If your Developer Software is for (A) Print-on-Demand, Marketing Platforms or Stock Affiliate Partners, or any other purpose not expressly defined in these Stock Developer Terms, you may not access, use, or display any Adobe Stock Works that include "editorial" in the file name or metadata; or (B) Asset Management Services or authorized Third Party Software Integrations, you must ensure "Editorial Use Only" is displayed prominently adjacent to any Adobe Stock Work includes "editorial" in the file name or metadata.

5. __Limited Use for Affiliate Partners.__ If your Developer Software is for Adobe Stock Affiliate Partners, you may use the Adobe Stock SDKs and APIs and Adobe Stock Works solely for the purposes of promoting Adobe Stock, subject to the Adobe Stock Affiliate Partner's agreement with Adobe.

6. __Credit and Disclaimer.__ Your Developer Software must clearly and conspicuously display attribution to Adobe Stock in the following format "Powered by Adobe Stock" hyperlinked to <http://stock.adobe.com> [or successor URL] and visible to end users of your Developer Software; and you must place the following disclaimer on the Developer Software: "This product uses the Adobe Stock [SDK and/or API], but is not certified, endorsed or sponsored by Adobe. [Your Name] is not affiliated with or related to Adobe."

7. __Trade and Advertising.__ Your display of the Adobe Stock Works must comply with all applicable trade and advertising rules and regulations.

8. __Caching.__ You must not cache or store any Adobe Stock Works or other data obtained via the Adobe Stock SDKs or APIs other than for reasonable periods, and no longer than as necessary to operate the Developer Software. You will refresh the collection of Adobe Stock Works and other data obtained via the Adobe Stock SDKs or APIs no less than once per day.

9. __Machine Learning and Artificial Intelligence.__ You must not use the Adobe Stock Works or any title, caption information, keywords or other metadata associated with the Adobe Stock Works for any (A) machine learning or artificial intelligence purposes; or (B) technologies designed or intended for the identification of natural persons.

10. __Effect of Termination on Adobe Stock Works.__ Upon termination of these Stock Developer Terms or request by Adobe, you will immediately remove any and all versions of the Adobe Stock Works that have not been otherwise licensed from Adobe. Adobe will have no liability for claims arising out your use of locally stored Adobe Stock Works.

11. __Disclaimer.__ Adobe is not responsible for your use of any information, materials, feedback, or answers to your questions which may be provided by Adobe or its representatives as a courtesy only.
Source: https://www.adobe.com/legal/terms.html.
9 changes: 4 additions & 5 deletions src/pages/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,11 +16,6 @@ import GettingStarted from './getting-started/index.md'
<GettingStarted />
-->

- [Please read me first!](#please-read-me-first)
- [Do I have Stock for Enterprise?](#do-i-have-stock-for-enterprise)
- [Adobe Affiliates](#adobe-affiliates)


# Please read me first!

Beginning in November, 2024, the Stock API will only be available to Stock for Enterprise customers. If you don't know if you have Stock for Enterprise, see [Do I have Stock for Enterprise?](#do-i-have-stock-for-enterprise) To create an integration, you must either be a System Administrator or a [member of the Developers group](https://helpx.adobe.com/enterprise/using/manage-developers.html) for the Stock product. *Hint: If you do not see an option to add Developers or API credentials, then you **do not** have Stock for Enterprise.* If you want to get a quote for Stock for Enterprise, please contact your Adobe account representative or [request a callback](https://www.adobe.com/creativecloud/business/enterprise.html#creativecloud-rfi).
Expand Down Expand Up @@ -55,3 +50,7 @@ While most Adobe Affiliates display banner advertising on their websites, affili
See the [Affiliates FAQ](faq/stock-api-business-faq.md#affiliates-faq) for more information.

Note that you will still need to join the [Stock API Prerelease program](https://www.adobeprerelease.com) as well as join the Adobe Affiliate program.

## Next steps

Once you have been accepted into the program or to access Stock API documentation, go to [Getting Started](./getting-started/01-getting-started.md).

0 comments on commit 2dd8a2f

Please sign in to comment.