MyPlex plexapi.myplex¶
classe plexapi.myplex.
MyPlexAccount
(username=Nenhum, senha=Nenhum, token=Nenhum, sessão=Nenhum, timeout=Nenhum)¶
Bases: plexapi.base.PlexObject
MyPlex de conta e informações de perfil. Este objecto representa os dados encontrados na conta myplex.tv servidores no url https://plex.tv/users/account. Pode criar este objectivo directamente passando no seu nome de utilizador & senha (ou item). Existe também um método conveniencemetd fornecido em myPlexAccount()
que irá criar e devolver este objecto.
parâmetros
-
utilizador – str) – o seu utilizador MyPlex.
-
senha – str) – a sua senha do MyPlex.sessão (pedidos.Sessão, opcional) – Use o seu próprio objecto de sessão se quiser associar as respostas http a partir de PMS
-
tempo-limite (int) – tempo-limite em segundos na ligação inicial ao myplex (configuração por omissão.LIMITE).
Variáveis
-
SIGNIN (str) – ‘https://plex.tv/users/sign_in.xml’
-
chave (str) – ‘https://plex.tv/users/account’
-
authenticationToken (str) – Desconhecido.
-
certificateVersion (str) – desconhecido.cloudSyncDevice (str) – desconhecido.
-
email (str) – o seu endereço de email Plex actual.
-
direitos (lista<str>) – lista de dispositivos que é permitido utilizar nesta conta.convidado (bool) – desconhecido.
-
home (bool) – desconhecido.
-
homeSize (int) – desconhecido.
-
id (int) – o seu ID da Conta Plex.
-
locale (str) – a sua localização Plex
-
mailing_ list_status (str) – o estado actual da sua lista de correio.
-
maxHomeSize (int) – desconhecido.
-
queueEmail – str) – endereço de E-mail para adicionar itens à sua fila de espera posterior.
-
queueueuid (str) – desconhecido.
-
Restrito (bool) – desconhecido.
-
roles – (List<str>) Lit of account roles. Inscrição Plexpass listada aqui.
-
scrobbleTypes (str) – Descrição
-
seguro (bool) – Descrição
-
subscriptionActive (bool) – True se o seu subsctiption está ativo.
-
subscriptionFeatures – (List<str>) Lista de recursos permitidos em sua assinatura.
-
subscriptionStatus (str) – representação de cadeias de subscriptionativas.
-
thumb (str) – URL da sua miniatura da conta.
-
título (str) – desconhecido. – Parece um nome falso.
-
utilizador (str) – o seu utilizador da conta.
-
uuid (str) – desconhecido.
-
_ Token (str) – Token used to access this client.
-
_session – obj) – solicita o objecto de sessão usado para aceder a este cliente.
subscriptionPlan (str) – nome do plano de Subscrição.
device
(nome=Nenhum, clientId=Nenhum)¶
Retorna MyPlexDevice
que corresponde ao nome especificado.
Parameters
-
name (str) – Name to match against.
-
clientId (str) – clientIdentifier para igualar.
devices
()¶
devolve uma lista de todos os MyPlexDevice
objectos ligados ao servidor.
resource
(nome)¶
Devolve o MyPlexResource
que corresponde ao nome indicado.
Parameters
name (str) – Name to match against.
resources
()¶
devolve uma lista de todos os MyPlexResource
objectos ligados ao servidor.
inviteFriend
(usuário, servidor, secções=Nenhum, allowSync=False, allowCameraUpload=False, allowChannels=False, filterMovies=Nenhum, filterTelevision=Nenhum, filterMusic=Nenhum)¶
Partilhar biblioteca de conteúdo com o usuário especificado.
Parameters
-
user (
MyPlexUser
) – MyPlexUser object, username, or Email of the user to be added. -
server (
PlexServer
) – PlexServer object, or machineIdentifiercontaining the library sections to share. -
seções (List<
LibrarySection
>) – Lista de LibrarySection objecs, ou namesto ser compartilhada (padrão Nenhum). as seções devem ser definidas para atualizar as bibliotecas compartilhadas. -
allowSync (Bool) – Set True para permitir que o usuário sincronize o conteúdo.
-
allowCameraUpload (Bool) – define True para permitir ao utilizador enviar fotografias.
-
allowChannels – Bool) – Set True para permitir que o usuário utilize os canais instalados.
-
filterMovies (Dict) – Dict contendo a chave ‘contentRating’ e/ou ‘label’ cada um definido numa lista de valores a filtrar. ex: {‘contentRating’:, ‘label’:}
-
filterTelevision (Dict) – Dict contendo a chave ‘contentRating’ e/ou ‘label’ cada um definido numa lista de valores a filtrar. ex: {‘contentRating’:, ‘label’:}
-
filterMusic (Dict) – Dict contendo a chave ‘label’ definida numa lista de valores a filtrar.ex: {‘label’:}
createHomeUser
(usuário, servidor, secções=Nenhum, allowSync=False, allowCameraUpload=False, allowChannels=False, filterMovies=Nenhum, filterTelevision=Nenhum, filterMusic=Nenhum)¶
Partilhar biblioteca de conteúdo com o usuário especificado.
Parameters
-
user (
MyPlexUser
) – MyPlexUser object, username, or Email of the user to be added. -
server (
PlexServer
) – PlexServer object, or machineIdentifiercontaining the library sections to share. -
seções (List<
LibrarySection
>) – Lista de LibrarySection objecs, ou namesto ser compartilhada (padrão Nenhum). as seções devem ser definidas para atualizar as bibliotecas compartilhadas. -
allowSync (Bool) – Set True para permitir que o usuário sincronize o conteúdo.
-
allowCameraUpload (Bool) – define True para permitir ao utilizador enviar fotografias.
-
allowChannels – Bool) – Set True para permitir que o usuário utilize os canais instalados.
-
filterMovies (Dict) – Dict contendo a chave ‘contentRating’ e/ou ‘label’ cada um definido numa lista de valores a filtrar. ex: {‘contentRating’:, ‘label’:}
-
filterTelevision (Dict) – Dict contendo a chave ‘contentRating’ e/ou ‘label’ cada um definido numa lista de valores a filtrar. ex: {‘contentRating’:, ‘label’:}
-
filterMusic (Dict) – Dict contendo a chave ‘label’ definida numa lista de valores a filtrar.ex: {‘label’:}
createExistingUser
(usuário, servidor, secções=Nenhum, allowSync=False, allowCameraUpload=False, allowChannels=False, filterMovies=Nenhum, filterTelevision=Nenhum, filterMusic=Nenhum)¶
Partilhar biblioteca de conteúdo com o usuário especificado.
Parameters
-
user (
MyPlexUser
) – MyPlexUser object, username, or Email of the user to be added. -
server (
PlexServer
) – PlexServer object, or machineIdentifiercontaining the library sections to share. -
seções (List<
LibrarySection
>) – Lista de LibrarySection objecs, ou namesto ser compartilhada (padrão Nenhum). as seções devem ser definidas para atualizar as bibliotecas compartilhadas. -
allowSync (Bool) – Set True para permitir que o usuário sincronize o conteúdo.
-
allowCameraUpload (Bool) – define True para permitir ao utilizador enviar fotografias.
-
allowChannels – Bool) – Set True para permitir que o usuário utilize os canais instalados.
-
filterMovies (Dict) – Dict contendo a chave ‘contentRating’ e/ou ‘label’ cada um definido numa lista de valores a filtrar. ex: {‘contentRating’:, ‘label’:}
-
filterTelevision (Dict) – Dict contendo a chave ‘contentRating’ e/ou ‘label’ cada um definido numa lista de valores a filtrar. ex: {‘contentRating’:, ‘label’:}
-
filterMusic (Dict) – Dict contendo a chave ‘label’ definida numa lista de valores a filtrar.ex: {‘label’:}
removeFriend
(utilizador)¶
remova o utilizador indicado de toda a partilha.
parâmetros
utilizador (str) – MyPlexUser, utilizador, e-mail do utilizador a adicionar.
removeHomeUser
(utilizador) parâmetros
utilizador (str) – MyPlexUser, utilizador, e-mail do utilizador a remover de casa.
updateFriend
(usuário, servidor, secções=Nenhum, removeSections=False, allowSync=Nenhum, allowCameraUpload=Nenhum, allowChannels=Nenhum, filterMovies=Nenhum, filterTelevision=Nenhum, filterMusic=Nenhum) n
de Atualização especificado do usuário configurações de compartilhamento.
Parameters
-
user (
MyPlexUser
) – MyPlexUser object, username, or Email of the user to be updated. -
server (
PlexServer
) – PlexServer object, or machineIdentifiercontaining the library sections to share. -
seções (List<
LibrarySection
>) – Lista de LibrarySection objecs, ou namesto ser compartilhada (padrão Nenhum). as seções devem ser definidas para atualizar as bibliotecas compartilhadas. -
removeSections (Bool) – Set True to remove all shares. Substitui as secções.
-
allowSync (Bool) – Set True para permitir que o usuário sincronize o conteúdo.
-
allowCameraUpload (Bool) – define True para permitir ao utilizador enviar fotografias.
-
allowChannels – Bool) – Set True para permitir que o usuário utilize os canais instalados.
-
filterMovies (Dict) – Dict contendo a chave ‘contentRating’ e/ou ‘label’ cada um definido numa lista de valores a filtrar. ex: {‘contentRating’:, ‘label’:}
-
filterTelevision (Dict) – Dict contendo a chave ‘contentRating’ e/ou ‘label’ cada um definido numa lista de valores a filtrar. ex: {‘contentRating’:, ‘label’:}
-
filterMusic (Dict) – Dict contendo a chave ‘label’ definida numa lista de valores a filtrar.ex: {‘label’:}
user
(utilizador)¶
Devolve o MyPlexUser
que corresponde ao E-mail ou ao utilizador indicado.
parâmetros
utilizador – str) – utilizador, e-mail ou id do utilizador a devolver.
users
()¶
devolve uma lista de todos os objectos MyPlexUser
ligados à sua conta.Isso inclui tanto amigos e convites pendentes. Pode consultar o utilizador.amigo todistinguish entre os dois.
optOut
(reprodução=nenhuma, biblioteca=nenhuma)¶
Opt in or out of sharing stuff with plex.Ver: https://www.plex.tv/about/privacy-legal/
syncItems
(cliente=Nenhum, clientId=Nenhum)¶
Retorna uma instância de SyncList
para o cliente especificado.
Parameters
-
client (
MyPlexDevice
) – a client to query SyncItems for. -
clientId – str) – um identificador de um cliente para consultar Sincitems.
Se tanto o cliente como o cliente preferissem.Se nem o cliente nem o cliente fornecessem o cliente seria definido como o identificador do cliente atual.
sync
(sync_item, client=None, clientId=None)¶
Adds specified sync item for the client. É sempre mais fácil usar métodos definidos diretamente nos mediaobjects, e.g. sync()
sync()
.
Parâmetros
-
cliente (
MyPlexDevice
) – um cliente para o qual você precisa adicionar SyncItem para. -
clientId – str) – um identificador de um cliente para o qual você precisa adicionar SyncItem.
-
sync_item (
SyncItem
) – objeto Sincitem preparado com todos os campos definidos.
Se tanto o cliente como o cliente preferissem.Se nem o cliente nem o cliente fornecessem o cliente seria definido como o identificador do cliente atual.
Devolve
uma instância de syncItem criado.
Return type
SyncItem
Raises
-
BadRequest – When client with provided clientId was not found.
-
BadRequest – Provided client doesn’t provides sync-target.
claimToken
()¶
Devolve um str, um novo “claim-token”, que poderá usar para registar a sua nova instância do servidor Plex à sua conta.Ver: https://hub.docker.com/r/plexinc/pms-docker/https://www.plex.tv/claim/
history
(maxresultados=9999999, mindate=None)¶
Get Play History for all library sections on all servers for the owner.: param maxresults: return Only the specified number of results (optional).: type maxresults: int: param mindate: Min datetime to return results from.: tipo mindate: datetime
videoOnDemand
()¶
Returns a list of VOD Hub items Hub
webShows
()¶
Returns a list of Webshow Hub items Hub
news
()¶
Returns a list of News Hub items Hub
podcasts
()¶
Returns a list of Podcasts Hub items Hub
tidal
()¶
Returns a list of tidal Hub items Hub
link
(pin)¶
Link a device to the account using a pin codigo.
parâmetros
pin – str) – o código pin de ligação de 4 dígitos.
classeplexapi.myplex.
MyPlexUser
(servidor de dados, initpath=Nenhum, parent=None)¶
Bases: plexapi.base.PlexObject
Este objeto representa de não-assinado em usuários como amigos e linkedaccounts. Nota: Isto não deve ser confundido com o MyPlexAccount
que é a sua conta específica. O XML bruto para os dados apresentados pode ser encontrado em: https://plex.tv/api/users/
Variáveis
-
a TAG (str) – ‘Usuário’
-
chave (str) – ‘https://plex.tv/api/users/’
-
allowCameraUpload (bool) – True se este usuário pode fazer upload de imagens.
-
allowChannels (bool) – True se este utilizador tiver acesso a canais.
-
allowSync – bool) – True if this user can sync.
-
email (str) – endereço de E-mail do utilizador ([email protected]).
-
filterAll (str) – desconhecido.
-
filterMovies (str) – desconhecido.
-
filterMusic (str) – desconhecido.
-
filterPhotos (str) – desconhecido.
-
filterTelevision (str) – desconhecido.
-
home (bool) – desconhecido.
-
id (int) – ID da Conta Plex do utilizador.
-
protegido (False) – desconhecido (possivelmente activado por SSL?).
-
recommendationsPlaylistId (str) – desconhecido.
-
Restrito (str) – desconhecido.
-
polegar (str) – ligação ao avatar dos utilizadores.
-
title (str) – parece ser um aliad para o nome de utilizador.
-
utilizador – str) – utilizador.
-
servidores – Servidores compartilhados entre o usuário e o amigo
server
(nome)¶
Retorna MyPlexServerShare
que corresponde ao nome especificado.
Parameters
name (str) – Name of the server to return.
history
(maxresults=9999999, mindate=None)¶
Get all Play History for a user in all shared servers.: param maxresults: return Only the specified number of results (optional).: type maxresults: int: param mindate: Min datetime to return results from.: tipo mindate: datetime
classeplexapi.myplex.
Section
(servidor de dados, initpath=Nenhum, parent=None)¶
Bases: plexapi.base.PlexObject
Isso refere-se a uma secção partilhada. O XML bruto para os dados apresentados pode ser encontrado em: https://plex.tv/api/servers/{machineId}/shared_servers/{serverId}
Variáveis
-
a TAG (str) – seção
-
id (int) – secção partilhada id
-
sectionKey (str) – chave que usamos para esta seção
-
title (str) – Título da seção
-
sectionId (str) – secção partilhada id
-
tipo (str) – filme, tvshow, artista
-
compartilhada (bool) – Se esta seção é compartilhada com o usuário
history
(maxresults=9999999, mindate=Nenhum)¶
todo o Histórico de um usuário, para esta seção deste servidor compartilhado.: param maxresults: Devolver apenas o número especificado de resultados (opcional).: type maxresults: int: param mindate: Min datetime to return results from.: type mindate: datetime
classMyPlexServerShare
(server, data, initpath=None, parent=none)¶
Bases: plexapi.base.PlexObject
representa uma referência ao servidor de um único utilizador. Usado para partilha de bibliotecas. variáveis
-
id (int) – id para esta partilha
-
serverId (str) – que id plex usa para isto.
-
machineIdentifier (str) – Os servidores machineIdentifier
-
nome (str) – Os servidores de nome
-
lastSeenAt (datetime) – Última conectado ao servidor?
-
numbrários – int) – número Total de bibliotecas
-
allbraries (bool) – verdadeiro se todas as bibliotecas forem partilhadas com este utilizador.
-
propriedade (bool) – 1 Se o servidor For propriedade do utilizador
-
pendente (bool) – verdadeiro se o convite estiver pendente.
section
(nome)¶
Retorna Section
que corresponde ao nome especificado.
Parameters
name – str) – Name of the section to return.
sections
()¶
devolve uma lista de todos os objectos Section
partilhados com este utilizador.
history
(maxresults=9999999, mindate=None)¶
Get all Play History for a user in this shared server.: param maxresults: return Only the specified number of results (optional).: type maxresults: int: param mindate: Min datetime to return results from.: tipo mindate: datetime
classeplexapi.myplex.
MyPlexResource
(servidor de dados, initpath=Nenhum, parent=None)¶
Bases: plexapi.base.PlexObject
Este objeto representa de recursos ligados ao seu Plex servidor que pode providecontent como o Plex Media Servidores, iPhone ou Android, clientes, etc. As matérias xmlfor os dados aqui apresentados podem ser encontrados em:https://plex.tv/api/resources?includeHttps=1&includeRelay=1
Variáveis
-
a TAG (str) – ‘Dispositivo’
-
chave (str) – ‘https://plex.tv/api/resources?includeHttps=1&includeRelay=1’
-
accessToken (str) – Este recursos accesstoken.
-
clientIdentifier (str) – ID único para este recurso.
-
connections (list) – List of
ResourceConnection
objects for this resource. -
createdAt – datetime) – Timestamp este recurso ligado pela primeira vez ao seu servidor.
-
dispositivo (str) – melhor palpite sobre o tipo de dispositivo que este é (PS, iPhone, Linux, etc).
-
home (bool) – desconhecido
-
lastSeenAt (datetime) – Timestamp this resource last connected.
-
name – str) – nome descritivo deste recurso.
-
propriedade (bool) – True se este recurso for um dos seus (registou-se nele).
-
plataforma (str) – OS o recurso está em execução (Linux, Windows, Chrome, etc.)
-
platformVersion (str) – versão da plataforma.
-
presence (bool) – True if the resource is online
-
product (str) – Plex product (Plex Media Server, Plex for iOS, Plex Web, etc.)
-
productVersion (str) – versão do produto.
-
Fornece (str) – lista de serviços que este recurso fornece (cliente, servidor,jogador, pubsub-player, etc.)
-
synced (bool) – Unknown (possibly True if the resource has synced content?)
connect
(ssl=Nenhum, timeout=Nenhum)¶
Retorna um novo PlexServer
ou PlexClient
objeto.Muitas vezes há mais de um endereço especificado para um servidor ou cliente.Esta função irá priorizar as conexões locais antes de remotos ou relay e HTTPS antes de HTTP.Depois de tentar se conectar a todos os endereços disponíveis para este recurso e acumular pelo menos uma conexão foi bem sucedida, o objeto PlexServer é construído e devolvido.
parâmetros
-
ssl (bool, opcional) – definir verdadeiro para se ligar apenas às ligações dos HTTPS. Configura o False para se ligar apenas às ligações de HTTP. Não definir nenhuma ligação (por omissão) a qualquer ligaçãohttp ou HTTPS.
-
tempo-limite (int, opcional) – o tempo-limite em segundos para tentar cada ligação.
aumenta
NotFound – quando não é possível ligar-se a quaisquer endereços para este recurso.
classeplexapi.myplex.
ResourceConnection
(servidor de dados, initpath=Nenhum, parent=None)¶
Bases: plexapi.base.PlexObject
Representa um Recurso de Conexão objeto encontrado dentro deMyPlexResource
objetos.
Variáveis
-
a TAG (str) – ‘Conexão’
-
endereço (str) – endereço IP Local
-
httpuri (str) – local address
-
local (bool) – Verdadeiro se o local
-
porta (int) – 32400
-
protocolo (str) – HTTP ou HTTPS
-
uri (str) – Endereço externo
classeplexapi.myplex.
MyPlexDevice
(servidor de dados, initpath=Nenhum, parent=None)¶
Bases: plexapi.base.PlexObject
este objeto representa recursos conectados ao seu servidor Plex que provideplayback capacidade de seus clientes Plex, iPhone ou Android, Plex Web,esta API, etc. As matérias xml para os dados aqui apresentados podem ser encontrados em:https://plex.tv/devices.xml
Variáveis
-
a TAG (str) – ‘Dispositivo’
-
chave (str) – ‘https://plex.tv/devices.xml’
-
clientIdentifier (str) – IDENTIFICAÇÃO exclusiva para este recurso.
-
conexões (lista) – Lista de URIs de conexão para o dispositivo.
-
dispositivo (str) – melhor palpite sobre o tipo de dispositivo que este é (Linux, iPad, AFTB, etc).
-
id (str) – id MyPlex do dispositivo.
-
model (str) – Model of the device (bueller, Linux, x86_64, etc.)
-
name – str) – Hostname of the device.
-
plataforma (str) – OS o recurso está em execução (Linux, Windows, Chrome, etc.)
-
platformVersion (str) – versão da plataforma.
-
produto (str) – Plex (Plex Media Server, Plex for iOS, Plex Web, etc.)
-
productVersion (texto) – versão do produto.
-
Fornece (str) – lista de serviços que este recurso fornece (cliente, controlador,alvo sincronizado, jogador, pubsub-player).
-
publicAddress (str) – endereço IP público.resolução do ecrã (750×1334, 1242×2208, etc.)
-
token – str) – token de autenticação Plex para o dispositivo.
-
vendedor (str) – vendedor de dispositivos (ubuntu, etc).
-
versão (str) – desconhecida (1, 2, 1.3.3.3148-b38628e, 1.3.15, etc.)
connect
(timeout=Nenhum)¶
Retorna um novo PlexClient
ou PlexServer
às Vezes existe mais de um endereço especificado para um servidor ou cliente.Depois de tentar se conectar a todos os endereços disponíveis para este cliente e assumir que pelo menos uma conexão foi bem sucedida, o objeto PlexClient é construído e devolvido.
aumenta
NotFound – quando não é possível ligar – se a quaisquer endereços para este dispositivo.
delete
()¶
remova este dispositivo da sua conta.
syncItems
()¶
devolve uma instância de SyncList
para o dispositivo actual.
aumenta
BadRequest-quando o dispositivo não fornece sync-target.
classeplexapi.myplex.
MyPlexPinLogin
(session=Nenhum, requestTimeout=Nenhum, cabeçalhos=Nenhum)¶
Bases: object
MyPlex PIN classe de login que suporta a obtenção de quatro caracteres PIN que o usuário mustenter no https://plex.tv/link para autenticar o cliente e proporcionar um token de acesso tocreate um MyPlexAccount
instância.Esta classe auxiliar suporta uma aproximação de votação, threaded e callback.
-
a abordagem de votação espera que o programador verifique periodicamente se a autenticação PIN foi bem sucedida usando
checkLogin()
. -
a abordagem roscada espera que o programador invoque
run()
e, em seguida, numa chamada posteriorwaitForLogin()
espere e verifique o resultado. -
a abordagem de callback é uma extensão da abordagem roscada e espera que o desenvolvimento passe o parâmetro de callback para a chamada para
run()
.O callback será chamado quando o thread espera que o login PIN seja bem sucedido ou expire. O parâmetro passado para o callback é o autenticationtoken recebido ou nenhum se o login expirou.
parâmetros
-
sessão (pedidos.Sessão, opcional) – Use o seu próprio objecto de sessão se quiser associar as respostas http do PMS
-
requestTimeout – int) – tempo-limite em segundos na ligação inicial ao plex.tv (configuração padrão.LIMITE).
Variáveis
-
PINOS (str) – ‘https://plex.tv/api/v2/pins’
-
CHECKPINS (str) – ‘https://plex.tv/api/v2/pins/{pinid}’
-
LINK (str) – ‘https://plex.tv/api/v2/pins/link’
-
POLLINTERVAL (int) – 1
-
terminado (bool) – Se o pino de início de sessão tenha terminado ou não.
-
expirou (bool) – quer o login do pin tenha caducado ou não.
-
token (str) – Token obtido através do login pin.
-
pin (str) – Pin a usar para o login em https://plex.tv/link.
run
(callback=nenhum, tempo-limite=nenhum)¶
inicia o tópico que monitoriza o estado de autenticação PIN.: param callback: Callback chamado com o token de autenticação recebido (opcional).: type callback:Callable: param timeout: Timeout in seconds waiting for the PIN login to succeed (optional).: tempo-limite do tipo: int
aumenta
-
RuntimeError-se o tópico já estiver em execução.
-
Rntimeerror – se a autenticação PIN do PIN actual tiver expirado.
waitForLogin
()¶
espera que o login PIN tenha sucesso ou expire.:chamada de volta do param: chamada de volta com o token de autenticação recebido (opcional).: type callback:Callable: param timeout: Timeout in seconds waiting for the PIN login to succeed (optional).: type timeout: int
Devolve
True se a autenticação PIN tiver sucesso ou False de outra forma.
stop