openapi: 3.0.0 info: title: eBay Account Advertising_eligibility Language API description: The Account API gives sellers the ability to configure their eBay seller accounts, including the seller's policies (eBay business policies and seller-defined custom policies), opt in and out of eBay seller programs, configure sales tax tables, and get account information.

For details on the availability of the methods in this API, see Account API requirements and restrictions. contact: name: eBay Inc, license: name: eBay API License Agreement url: https://go.developer.ebay.com/api-license-agreement version: v1.9.2 servers: - url: https://api.ebay.com{basePath} description: Production variables: basePath: default: /sell/account/v1 tags: - name: Language paths: /translate: post: tags: - Language description: This method translates listing title and listing description text from one language into another. For a full list of supported language translations, see the table in the API Overview page. operationId: translate parameters: - name: Content-Type in: header description: This header indicates the format of the request body provided by the client. Its value should be set to application/json.

For more information, refer to HTTP request headers. required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/TranslateRequest' required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TranslateResponse' '400': description: Bad Request x-response-codes: errors: '110001': domain: API_TRANSLATION category: REQUEST description: From language is invalid, missing or not supported. For more information, see the API call reference documentation. '110002': domain: API_TRANSLATION category: REQUEST description: To language is invalid, missing or not supported. For more information, see the API call reference documentation. '110003': domain: API_TRANSLATION category: REQUEST description: Context is not supported. For more information, see the API call reference documentation. '110004': domain: API_TRANSLATION category: REQUEST description: Maximum number of input text reached. For more information, see the API call reference documentation. '110005': domain: API_TRANSLATION category: REQUEST description: Maximum length of input text reached. For more information, see the API call reference documentation. '110006': domain: API_TRANSLATION category: REQUEST description: Unsupported from and to combination. '110007': domain: API_TRANSLATION category: REQUEST description: Markups are not supported in input texts for title translation context. '110008': domain: API_TRANSLATION category: REQUEST description: Input text missing. '500': description: Internal Server Error x-response-codes: errors: '110000': domain: API_TRANSLATION category: APPLICATION description: There was a problem with an eBay internal system or process. Contact eBay developer support for assistance. security: - api_auth: - https://api.ebay.com/oauth/api_scope components: schemas: Translation: type: object properties: originalText: type: string description: The original text, in the language specified in the from field, that was input into the text field in the request. translatedText: type: string description: The translation of the original text into the language specified in the to field. description: This type is used by the translations array, which shows the original text supplied by the user in the request payload, and the text translated by eBay.

Only one input string can be translated at this time. Support for multiple continuous text strings is expected in the future. TranslateResponse: type: object properties: from: type: string description: The enumeration value indicates the language of the input text. For implementation help, refer to eBay API documentation to: type: string description: The enumeration value indicates the language of the translated text. For implementation help, refer to eBay API documentation translations: type: array description: An array showing the input and translated text. Only one input string can be translated at this time. Support for multiple continuous text strings is expected in the future. items: $ref: '#/components/schemas/Translation' description: This is the base type of the translate method response payload. TranslateRequest: type: object properties: from: type: string description: The language of the input text to be translated. Not all LanguageEnum values are supported in this field. For a full list of supported language pairings, see the Supported languages table in the API Overview page. For implementation help, refer to eBay API documentation text: type: array description: 'The input text to translate. The maximum number of characters permitted is determined by the translationContext value:Note: Currently, only one input string can be translated per API call. Support for multiple continuous text strings is expected in the future.' items: type: string to: type: string description: The target language for the translation of the input text. Not all LanguageEnum values are supported in this field. For a full list of supported language pairings, see the Supported languages table in the API Overview page. For implementation help, refer to eBay API documentation translationContext: type: string description: Input the listing entity to be translated.

Valid Values: ITEM_TITLE and ITEM_DESCRIPTION

For implementation help, refer to eBay API documentation description: This is the base type of the translate method request payload. securitySchemes: api_auth: type: oauth2 description: The security definitions for this API. Please check individual operations for applicable scopes. flows: authorizationCode: authorizationUrl: https://auth.ebay.com/oauth2/authorize tokenUrl: https://api.ebay.com/identity/v1/oauth2/token scopes: https://api.ebay.com/oauth/api_scope/sell.account.readonly: View your account settings https://api.ebay.com/oauth/api_scope/sell.account: View and manage your account settings