-
Notifications
You must be signed in to change notification settings - Fork 45
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.
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.
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.
Da uns ein paar Nutzer darauf hingewiesen haben, dass sie es einfacher finden das XML selbst zu erzeugen und durchzureichen (wie unter http://api.immobilienscout24.de/our-apis/import-export.html beschrieben), wurde ein zusätzlicher Parameter ("xml") zur Verfügung gestellt. Die anderen Pflichtparameter können also weggelassen werden. Somit können im Grunde bereits alle Immobilien-Typen zu ImmobilienScout24 exportiert werden. Hat man den XML-Code erstellt, kann man folgenden Code ausführen:
<?php
$aParameter = array(
'username' => 'USERNAME',
'service' => 'immobilienscout',
'estate' => array(
'xml' => /* ... Kompletter XML Body ... */
));
print_r($oImmocaster->exportObject($aParameter));
// or
// print_r($oImmocaster->changeObject($aParameter));
?>Bitte daran denken, dass der Wert für xml ein String ist und kein Array. Es wird der komplette XML-Body übergeben. Wie dieser aussieht, wird im IS24 Wiki unter http://api.immobilienscout24.de/our-apis/import-export.html erklärt. Dort gibt es eine Zip-Datei, die Beispiele für alle Objekt-Typen enthält. Der XML Code muss nur aus der Datei per Copy und Paste in den Wert des XML Parameters kopiert werden.
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',
'type' => 'Picture');
$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