Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica as definições de recorte ao suporte de dados de imagem armazenado para uma proporção específica.
Nota
Nem todos têm esta funcionalidade ainda. Se não o fizer, não se preocupe. Está a chegar em breve.
Se não especificar as definições de recorte, o serviço irá recortar automaticamente para a área máxima possível a partir do centro da imagem. Por exemplo, com uma imagem de 1000x1000 píxeis, para a proporção de 1,91:1, a definição de recorte automático será CropWidth=1000, CropHeight=524, CropX=0 e CropY=238.
Sintaxe
<xs:complexType name="ImageAsset" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:Asset">
<xs:sequence>
<xs:element minOccurs="0" name="CropHeight" nillable="true" type="xs:int" />
<xs:element minOccurs="0" name="CropWidth" nillable="true" type="xs:int" />
<xs:element minOccurs="0" name="CropX" nillable="true" type="xs:int" />
<xs:element minOccurs="0" name="CropY" nillable="true" type="xs:int" />
<xs:element minOccurs="0" name="SubType" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="TargetHeight" nillable="true" type="xs:int">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="TargetWidth" nillable="true" type="xs:int">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Elementos
O objeto ImageAsset tem os seguintes elementos: CropHeight, CropWidth, CropX, CropY, SubType, TargetHeight, TargetWidth.
Elemento | Descrição | Tipo de Dados |
---|---|---|
CropHeight | O número de píxeis a utilizar a partir da origem do recurso de imagem, começando pela posição CropY e movendo-se para cima. Adicionar: Opcional. Se não definir este elemento, o serviço irá recortar automaticamente de acordo com a proporção do Subtipo. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. |
int |
CropWidth | O número de píxeis a utilizar a partir da origem do recurso de imagem, começando pela posição CropX e movendo-se para a direita. Adicionar: Opcional. Se não definir este elemento, o serviço irá recortar automaticamente de acordo com a proporção do Subtipo. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. |
int |
CropX | A partir do canto inferior esquerdo da origem do recurso de imagem, este é o número de píxeis a ignorar para a direita no eixo x antes de aplicar a CropWidth. Adicionar: Opcional. Se não definir este elemento, o serviço irá recortar automaticamente de acordo com a proporção do Subtipo. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. |
int |
Recortar | A partir do canto inferior esquerdo da origem do recurso de imagem, este é o número de píxeis a saltar para cima no eixo y antes de aplicar o CropHeight. Adicionar: Opcional. Se não definir este elemento, o serviço irá recortar automaticamente de acordo com a proporção do Subtipo. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. |
int |
Subtipo | Representa a proporção para este recurso de imagem. A proporção do sub-tipo tem de corresponder às dimensões efetivas do recurso de imagem. Se CropHeight e CropWidth não forem utilizados, a proporção do subtipo tem de corresponder à proporção do suporte de dados de imagem armazenado. Se CropHeight e CropWidth forem utilizados, a verdadeira proporção do suporte de dados armazenado na biblioteca de multimédia ao nível da conta pode ser diferente, desde que CropHeight e CropWidth resultem na proporção correta. Em ambos os casos, a verdadeira proporção do suporte de dados armazenado na biblioteca de multimédia ao nível da conta permanecerá inalterada. O subtipo tem de ser definido como "Logótipo" se a imagem estiver associada a um anúncio como "LandscapeLogoMedia" ou "SquareLogoMedia". Os valores de subtipo possíveis incluem OriginalImage, LandscapeLogoMedia, SquareLogoMedia, LandscapeImageMedia, SquareImageMedia, ImageMedia169X100, ImageMedia201X100, ImageMedia120X100, ImageMedia200X100, ImageMedia124X100, ImageMedia153X100. Para obter mais detalhes, veja Comentários ResponsiveAd. Nota: a partir de agora, SubType OriginalImage substitui a função landscapeImageMedia como a imagem predefinida para ResponsiveAd of Audience Campaign. Poderão ser adicionados novos subtipos no futuro, pelo que não deve assumir qualquer dependência num conjunto fixo de valores. Adicionar: Necessário Atualização: Só de leitura. Não é possível atualizar o subtipo durante a atualização. |
cadeia |
TargetHeight | A dimensão de altura de destino de um recurso de imagem. | int |
TargetWidth | A dimensão de largura de destino de um recurso de imagem. | int |
O objeto ImageAsset tem Elementos Herdados.
Elementos Herdados
Elementos Herdados do Recurso
O objeto ImageAsset deriva do objeto Asset e herda os seguintes elementos: ID, Nome, Tipo. As descrições abaixo são específicas de ImageAsset e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto Asset .
Elemento | Descrição | Tipo de Dados |
---|---|---|
ID | O identificador exclusivo do Microsoft Advertising para o recurso numa conta do Microsoft Advertising. O mesmo identificador de recurso de imagem pode ser utilizado várias vezes no mesmo anúncio para diferentes proporções e também pode ser utilizado por vários anúncios na mesma conta microsoft Advertising. O identificador do recurso de imagem com SubType definido como LandscapeImageMedia é utilizado para todos os subtipos de recursos de imagem gerados automaticamente no mesmo anúncio. Quer permita ou não que o Microsoft Advertising gere automaticamente as imagens recortadas, o ID não tem de ser exclusivo entre os recursos de imagem associados ao mesmo anúncio. Pode criar suportes de dados para anúncios reativos através da operação do serviço AddMedia . Em seguida, pode utilizar o identificador de multimédia devolvido como o ID do recurso de imagem. A proporção da imagem que adicionou tem de ser suportada para o Subtipo do recurso de imagem. Adicionar: Necessário Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. |
Longo |
Nome | Reservado para utilização futura. Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. |
cadeia |
Tipo | O tipo do elemento. Este valor é ImageAsset quando obtém um recurso de imagem. Para obter mais informações sobre tipos de recursos, veja Observações de Objetos de Dados de Recurso. Adicionar: Só de leitura Atualização: Só de leitura |
cadeia |
Requisitos
Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13