New York Times (Editora Independente)

O New York Times permite que qualquer pessoa pesquise artigos por palavra-chave, data, seção e popularidade. Esse conector permite que um usuário extraia esses dados para seu aplicativo, fluxo ou relatório.

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD)
Aplicações Power	Premium	Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Automatize o poder	Premium	Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Roy Paar
Email	roypaar@microsoft.com

Metadados do conector
Editora	Roy Paar
Sítio Web	https://nytimes.com
Política de privacidade	https://www.nytimes.com/privacy/privacy-policy
Categorias	Estilo de vida e entretenimento

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:


Predefinição	Parâmetros para criar conexão.	Todas as regiões	Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
apikey	securestring	O apikey para esta api	Verdade

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	100	60 segundos

Ações

Devolve uma lista das principais histórias por secção	O serviço Top Stories retorna uma matriz de artigos atualmente na seção especificada.
Devolve uma lista de artigos com base na pesquisa por palavra-chave	Pesquise artigos do NYT por palavras-chave.
Devolve uma lista dos artigos mais visualizados no NYTimes.com por período de tempo	Retorna uma matriz dos artigos mais visualizados no NYTimes.com por um período de tempo especificado (1 dia, 7 dias ou 30 dias).

Devolve uma lista das principais histórias por secção

ID da Operação:: TopStories

O serviço Top Stories retorna uma matriz de artigos atualmente na seção especificada.

Parâmetros

Name	Chave	Necessário	Tipo	Description
A seção em que a loja aparece.	section	True	string	A seção em que a história aparece.

Devoluções

Name	Caminho	Tipo
estado	status	string
Copyright	copyright	string
section	section	string
last_updated	last_updated	string
results	results	array of Article

Devolve uma lista de artigos com base na pesquisa por palavra-chave

ID da Operação:: ArticleSearch

Pesquise artigos do NYT por palavras-chave.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Keyword	q	True	string	Query
Data de início (por exemplo, 20120101)	begin_date		string	Data de início (por exemplo, 20120101)
Data de fim (por exemplo, 20121231)	end_date		string	Data de fim (por exemplo, 20121231)

Devoluções

Name	Caminho	Tipo
estado	status	string
Copyright	copyright	string
documentos	response.docs	array of Article
meta	response.meta	object

Devolve uma lista dos artigos mais visualizados no NYTimes.com por período de tempo

ID da Operação:: MostViewed

Retorna uma matriz dos artigos mais visualizados no NYTimes.com por um período de tempo especificado (1 dia, 7 dias ou 30 dias).

Parâmetros

Name	Chave	Necessário	Tipo	Description
Período de 1, 7 ou 30 dias.	period	True	integer	Período de 1, 7 ou 30 dias.

Devoluções

Name	Caminho	Tipo	Description
estado	status	string	Status de resposta da API (por exemplo, OK).
Copyright	copyright	string	Mensagem de direitos de autor.
results	results	array of ViewedArticle	Matriz de artigos.

Definições

Artigo

Name	Caminho	Tipo
web_url	web_url	string
fragmento	snippet	string
print_page	print_page	string
origem	source	string
manchete	headline	Headline
Palavras Chave	keywords	array of Keyword
pub_date	pub_date	string
document_type	document_type	string
news_desk	news_desk	string
type_of_material	type_of_material	string
_id	_id	string
classificação	score	integer
URI	uri	string

Manchete

Name	Caminho	Tipo
principal	main	string
chutador	kicker	string
content_kicker	content_kicker	string
print_headline	print_headline	string
nome	name	string
SEO	seo	string
submarino	sub	string

Keyword

Name	Caminho	Tipo
nome	name	string
valor	value	string
major	major	string

Artigo Revisado

Name	Caminho	Tipo	Description
URL	url	string	URL do artigo.
adx_keywords	adx_keywords	string	Lista de palavras-chave separadas por ponto-e-vírgula.
coluna	column	string	Deprecated. Definido como null.
section	section	string	Secção do artigo (por exemplo, Desporto).
BYLINE	byline	string	Texto do artigo (por exemplo, de Thomas L. Friedman).
tipo	type	string	Tipo de ativo (por exemplo, artigo, interativo, ...).
title	title	string	Manchete do artigo (por exemplo, Quando os violoncelos tocam, as vacas voltam para casa).
RESUMO	abstract	string	Breve resumo do artigo.
published_date	published_date	string	Quando o artigo foi publicado na web (por exemplo, 2021-04-19).
origem	source	string	Editora (por exemplo, New York Times).
des_facet	des_facet	array of string	Matriz de facetas de descrição (por exemplo, Quarentena (Vida e Cultura)).
org_facet	org_facet	array of string	Variedade de facetas da organização (por exemplo, Sullivan Street Bakery).
per_facet	per_facet	array of string	Variedade de facetas pessoais (por exemplo, Bittman, Mark).
geo_facet	geo_facet	array of string	Matriz de facetas geográficas (por exemplo, Canadá).
suporte de dados	media	array of Media	Matriz de imagens.
URI	uri	string	Identificador global exclusivo de um artigo.

MÍDIA

Name	Caminho	Tipo	Description
tipo	type	string	Tipo de ativo (por exemplo, imagem).
Subtipo	subtype	string	Subtipo de ativo (por exemplo, foto).
legenda	caption	string	Legenda da mídia.
Copyright	copyright	string	Crédito de mídia.
mídia-metadados	media-metadata	array of MediaMetadata	Metadados multimédia (url, largura, altura, ...).

Metadados de mídia

Name	Caminho	Tipo	Description
URL	url	string	URL da imagem.
format	format	string	Nome do recorte da imagem.