/**
* Insert multiple entities
*
* No service requests are run when this method is called.
* Use {@see Google\Cloud\Datastore\Transaction::commit()} to commit changes.
*
* Example:
* ```
* $entities = [
* $datastore->entity('Person', ['firstName' => 'Bob']),
* $datastore->entity('Person', ['firstName' => 'John'])
* ];
*
* $transaction->insertBatch($entities);
* $transaction->commit();
* ```
*
* @param Entity[] $entities The entities to insert.
* @return Transaction
*/
public function insertBatch(array $entities)
{
$entities = $this->operation->allocateIdsToEntities($entities);
foreach ($entities as $entity) {
$this->mutations[] = $this->operation->mutation('insert', $entity, Entity::class);
}
return $this;
}