-
Notifications
You must be signed in to change notification settings - Fork 44
Objekte exportieren
Alle Funktionen zum Exportieren von Objektinformationen und Dateien zu ImmobilienScout24. Hierfür benötigt man eine besondere Berechtigung, die erst von ImmobilienScout24 freigeschaltet werden muss. Sobald die Berechtigung freigeschaltet sind, man die Applikation zertifiziert hat, können Informationen zu ImmobilienScout24 exportiert werden.
Das Anlegen und Bearbeiten von Kontaktadressen ist noch nicht im SDK enthalten und vorerst auch nicht eingeplant.
Diese Methode ist hilfreich, um die Namen der Kanäle (Channels) zu ermitteln, in die ein Anbieter seine Objekte exportieren darf.
<?php
$aParameter = array('username'=>'USERNAME');
$res = $oImmocaster->getPublishChannel($aParameter);
?>Als Rückgabe erhält man die IDs und Titel der Kanäle in die der User seine Informationen exportieren darf.
username - Der Benutzername des Anbieters, der bei ImmobilienScout24 verwendet wird. Der Platzhalter "me" kann hier leider nicht verwendet werden.
ACHTUNG: Das Mapping wird demnächst eingestellt. Nutzen Sie also bitte nur das Beispiel, bei dem das XML selbst erzeugt wird. D.h. die Version bei der der Parameter estate['xml'] übergeben wird.
Für den Export von Objektdaten, muss die Applikation zertifiziert sein. Außerdem muss man sicherstellen, dass man in den Kanal (Channel) auch exportieren darf. Für den Export benötigt man außerdem die Rechte von ImmobilienScout24 um den Export durchführen zu dürfen.
<?php
$aParameter = array(
'username' => 'me',
'service' => 'immobilienscout',
'estate' => array(
'type' => 'apartmentBuy',
'objectId' => '12345',
'title' => 'Tolle Test-Wohnung',
// ... weitere Parameter ...
));
print_r($oImmocaster->exportObject($aParameter));
?>Als Rückgabe erhält man die Information, ob der Export erfolgreich war.
type - Muss den Wert "apartmentRent" für "Wohnung mieten haben.
title - Überschrift/Titel eines Objekts.
street - Straße des Objekts.
houseNumber - Hausnummer des Objekts.
zip - Postleitzahl des Objekts.
city - Stadt in der das Objekt liegt.
showFullAddress - Gibt an ob die komplette Adresse angezeigt werden soll (true/false).
baseRentPrice - Preis für das Objekt.
hasCourtage - Gibt an ob es eine Provision für das Objekt gibt (true/false).
livingSpaceSqm - Fläche des Objekts in Quadratmeter.
numberOfRooms - Anzahl der Zimmer des Objekts.
<?php
$aParameter = array(
'username' => 'me',
'service' => 'immobilienscout',
'estate' => array(
'type' => 'apartmentRent',
'title' => 'Meine Test-Wohnung',
'street' => 'Andreasstrasse',
'houseNumber' => '10',
'zip' => '10243',
'city' => 'Berlin',
'showFullAddress' => false,
'baseRentPrice' => 500,
'hasCourtage' => false,
'livingSpaceSqm' => 80,
'numberOfRooms' => 3
));
print_r($oImmocaster->exportObject($aParameter));
?>Alle Parameter sind im SDK in der Datei /Immocaster/Xml/Writer/Immobilienscout/Apartmentrent.php zu finden
type - Muss den Wert "apartmentBuy" für "Wohnung kaufen" haben.
title - Überschrift/Titel eines Objekts.
zip - Postleitzahl des Objekts.
city - Stadt in der das Objekt liegt.
showFullAddress - Gibt an ob die komplette Adresse angezeigt werden soll (true/false).
baseBuyPrice - Preis für das Objekt.
currency - Währung der Preisangabe.
livingSpaceSqm - Fläche des Objekts in Quadratmeter.
numberOfRooms - Anzahl der Zimmer des Objekts.
Alle Parameter sind im SDK in der Datei /Immocaster/Xml/Writer/Immobilienscout/Apartmentbuy.php zu finden
type - Muss den Wert "houseRent" für "Haus mieten haben.
title - Überschrift/Titel eines Objekts.
zip - Postleitzahl des Objekts.
city - Stadt in der das Objekt liegt.
showFullAddress - Gibt an ob die komplette Adresse angezeigt werden soll (true/false).
buildingType - Art der Immobilie: special (Spezial-Immobilie), castle (Burg/Schloß), villa (Villa), houseSemidetached (Reihenhaus), farmhouse (Farm/Bauernhof), bungalow (Bungalow), houseEndTerrace, houseMidTerrace, houseMultyFamily (Mehrfamilienhaus), houseSingleFamily (Einfamilienhaus), default (keine Angabe), other (Andere Immobilie)
baseRentPrice - Preis für das Objekt.
currency - Währung der Preisangabe.
livingSpaceSqm - Fläche des Objekts in Quadratmeter.
numberOfRooms - Anzahl der Zimmer des Objekts.
Alle Parameter sind im SDK in der Datei /Immocaster/Xml/Writer/Immobilienscout/Housetrent.php zu finden
type - Muss den Wert "houseBuy" für "Haus kaufen" haben.
title - Überschrift/Titel eines Objekts.
zip - Postleitzahl des Objekts.
city - Stadt in der das Objekt liegt.
showFullAddress - Gibt an ob die komplette Adresse angezeigt werden soll (true/false).
buildingType - Art der Immobilie: special (Spezial-Immobilie), castle (Burg/Schloß), villa (Villa), houseSemidetached (Reihenhaus), farmhouse (Farm/Bauernhof), bungalow (Bungalow), houseEndTerrace, houseMidTerrace, houseMultyFamily (Mehrfamilienhaus), houseSingleFamily (Einfamilienhaus), default (keine Angabe), other (Andere Immobilie)
baseBuyPrice - Preis für das Objekt.
buyPriceCurrency - Währung der Preisangabe.
livingSpaceSqm - Fläche des Objekts in Quadratmeter.
plotArea - Fläche des Grundstücks in Quadratmeter.
numberOfRooms - Anzahl der Zimmer des Objekts.
Alle Parameter sind im SDK in der Datei /Immocaster/Xml/Writer/Immobilienscout/Housebuy.php zu finden
Für den Bild-Export muss die Applikation zertifiziert sein und bereits ein Objekt angelegt sein, dem man ein Bild hinzufügen möchte. Das Anlegen von Objekten und Anfügen von Bildern muss in zwei getrennten Schritten geschehen. Deshalb muss man vorerst ein Objekt bei ImmobilienScout24 anlegen, da man die ID des Objekts für den Bild-Export benötigt.
<?php
$aParameter = array('file' => 'testbild.jpg', 'estateid' => '1234567890');
$res = $oImmocaster->exportObjectAttachment($aParameter));
?>Als Rückgabe erhält man die Information, ob der Bild-Export erfolgreich war.
file - Dateiname inkl. Pfad des Bild, das exportiert werden soll.
estateid - ID des Objektes dem das Bild hinzugefügt werden soll.
Objekte können für einzelnen Channels (Kanäle) deaktiviert werden. Jeder Channel hat seine ID (ImmobilienScout24=10000, Homepage=10001). Zum deaktivieren ruft man folgende Funktion mit der entsprechenden ID des Objects und dem Kanal für den das Objekt deaktiviert werden soll auf:
<?php
$aParameter = array(
'exposeid' => 'ESTATEID', // Id des Objekts
'channelid' => '10001'
);
$oImmocaster->disableObject($aParameter);
?>Als Rückgabe erhält man die Info, ob das Deaktivieren erfolgreich war..
exposeid - ID des Objects das deaktiviert werden soll. Hier wird üblicherweise die ImmobilienScout-ID angegeben. Optional kann man auch seine intern verwendete ID nutzen, die man vorher beim Export mitgegeben hat. Hierbei muss man allerdings ein "ext-" vor die ID schreiben. Das heißt aus "12345" wird zum Beispiel "ext-12345".
dddd